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Preface 


This is the Programmer Manual for the TDS 200-Series oscillo- 
scopes. This manual provides information about operating your 
instrument using an RS-232 or GPIB interface (available with 
optional TDS2CM Communications Extension Module or TDS2MM 
Measurement Extension Module). 


Related Manuals 


The following table lists related oscilloscope documentation. 


TDS 200-Series 
Extension 
Module 
User Manual Service Manual | Instructions 
Language Part Number Part Number Part Number 


English 070-8483-XX | 070-9693-XX _ | 070-9565-XX 
French 070-8520-XX | ———_—| 070-9567-XX 
German 070-8484-XX | =| 070-9566-XX 


Korean 070-9564-XX 070-9575-XX 


Italian 070-8980-XX 070-9569-XX 


Portuguese 070-9561-XX | ‘| 070-9571-XX 
Spanish 070-9560-XX 070-9570-XX 


Simplified 070-9563-XX 070-9573-XX 
Chinese 
Traditional 070-9568-XX 070-9574-XX 
Chinese 


Japanese 070-9562-XX 


070-9572-XX 
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Conventions 


Refer to the Command Syntax section of the Syntax and Commands 
chapter (page 2—1) for information about command conventions. 
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Getting Starte 


Before you can use this programming manual you must have 
installed a TDS2CM or TDS2MM Extension Module onto your TDS 
200-Series oscilloscope. Follow the instructions in the 

TDS 200-Series Extension Module Instructions document to install, 
test, and configure your extension module. 


Refer to the TDS 210 & TDS 220 User Manual for general 
information about how to operate the oscilloscope. 
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Boanitand's Syntax 


a see 
soe saat 


ee patate ae _ 


You can control the oscilloscope through the GPIB or RS-232 
interface using a large group of commands and queries. This section 
describes the syntax these commands and queries use and the 
conventions the oscilloscope uses to process them. The commands 
and queries themselves are listed in the Command Descriptions 
section. 


You transmit commands to the oscilloscope using the enhanced 
American Standard Code for Information Interchange (ASCH) 
character encoding. Appendix A contains a chart of the ASCII 
character set. 


This manual use Backus-Naur Form (BNF) notation to describe 
commands and queries. Table 2—1 lists the BNF symbols that this 
manual uses. 


Table 2-1: BNF notation 


Meaning 
Defined element 
Is defined as 


Exclusive OR 


Group; one element is required 


Optional; can be omitted 


Previous element(s) may be 
repeated 


Comment 
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Command and Query Structure 


ieee 


Commands consist of set commands and query commands (usually 
simply called commands and queries). Commands change instrument 
settings or perform a specific action. Queries cause the oscilloscope 
to return data and information about its status. 


Most commands have both a set form and a query form. The query 
form of the command is the same as the set form except that it ends 
with a question mark. For example, the set command ACQui re:MO0De 
has a query form ACQuire:MODe?. Not all commands have both a set 
and a query form; some commands are set only and some are query 
only. 


A few commands do both a set and query action. For example, the 
*CAL? command runs a self-calibration program on the oscilloscope, 
then returns the result of the calibration. 


A command message is a command or query name, followed by any 
information the oscilloscope needs to execute the command or query. 
Command messages consist of five different element types, which 
are defined in Table 2—2 and shown in Figure 2-1. 


Table 2-2: Command message elements 


Symbol Meaning 


<Header> The basic command name. If the header ends with a 
question mark, the command is a query. The header may 
begin with a colon (:) character; if the command is 
concatenated with other commands the beginning colon is 
required. The beginning colon can never be used with 
command headers beginning with a star (*). 


<Mnemonic> A header subfunction. Some command headers have only 
one mnemonic. If a command header has multiple 
mnemonics, they are always separated from each other by 
a colon (:) character. 


<Argument> A quantity, quality, restriction, or limit associated with the 
header. Not all commands have an argument, while other 
commands have multiple arguments. Arguments are 
separated from the header by a <Space>. Arguments are 
separated from each other by a <Comma>. 
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Table 2-2: Command message elements (Cont.) 


Meaning 


A single comma between arguments of multiple-argument 
commands. It may optionally have white space characters 
before and after the comma. 


<Comma> 


A white space character between command header and 
argument. It may optionally consist of multiple white space 
characters. 


<Space> 


Header Comma 


ct nis a 
SAVe:WAVEform CH1,REFA 


VV 


Mnemonics. | Arguments 
Space 


Figure 2-1: Command message elements 


Commands 


Commands cause the oscilloscope to perform a specific function or 
change one of its settings. Commands have the structure: 


[:]<Header>[<Space><Argument>[<Comma><Argument>] ...] 


A command header is made up of one or more mnemonics arranged 
in a hierarchical or tree structure. The first mnemonic is the base or 
root of the tree and each subsequent mnemonic is a level or branch 
off of the previous one. Commands at a higher level in the tree may 
affect those at a lower level. The leading colon (:) always returns you 
to the base of the command tree. 
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Queries 


Queries cause the oscilloscope to return information about its status 
or settings. Queries have the structure: 


[:]<Header>? 
[:]<Header>? [<Space><Argument>[<Comma><Argument>] ...] 


You can specify a query command at any level within the command 
tree unless otherwise noted. These branch queries return information 
about all the mnemonics below the specified branch or level. For 
example, MEASUrement :MEAS<x>:UNIts? returns the measurement 
units, while MEASUrement :MEAS<x>: TYPe? returns the measurement 
type selected for the measurement, and MEASUrement :MEAS<x>? 
returns all the measurement parameters for the specified measure- 
ment. 


Headers in Query Responses 


You can control whether the instrument returns headers as part of the 
query response. Use the HEADer command to control this feature. If 
header is on, the instrument returns command headers as part of the 
query and formats the query response as a valid set command. When 
header is off, the instrument sends back only the values in the 
response. This format can make it easier to parse and extract the 
information from the response. Table 2—3 shows the difference in 
responses. 


Table 2-3: Comparison of header off and on responses 


Header On 
Response 


:ACQUIRE:NUMAVG 64 
:CH1:COUPLING DC 


Header Off 
Response 


ACQuire:NUMAVg? 
CH1:COUP1 ing? 


2-4 TDS 200-Series Programmer Manual 


Command Syntax 


Clearing the Output Queue 


To clear the output queue and reset the oscilloscope to accept a new 
command or query, use the Device Clear (DCL) GPIB command or 
the RS-232 break signal. 


Command Entry 


Follow these general rules when entering commands: 
= Enter commands in upper or lower case. 


® You can precede any command with white space characters. 
White space characters include any combination of the ASCII 
control characters 00 through 09 and OB through 20 hexidecimal 
(0 through 9 and 11 trough 32 decimal). 


m The oscilloscope ignores commands that consists of just a 
combination of white space characters and line feeds. 


Abbreviating Commands 


You can abbreviate many oscilloscope commands. These abbrevi- 
ations are shown in capital letters in the command listing in the 
Command Groups section on page 2-15 and Command Descriptions 
section on page 2-33. For example, the command ACQui re: NUMAvg 
can be entered simply as ACQ: NUMA or acq:numa. 


If you use the HEADer command to have command headers included 
as part of query responses, you can also control whether the returned 
headers are abbreviated or are full-length using the VERBos 
command. 
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Concatenating Commands 


You can concatenate any combination of set commands and queries 
using a semicolon (;). The oscilloscope executes concatenated 
commands in the order received. When concatenating commands and 
queries you must follow these rules: 


= Completely different headers must be separated by both a 
semicolon and by the beginning colon on all commands but the 
first. For example, the commands TRIGger:MODe NORMal and 
ACQuire:NUMAVg 16 can be concatenated into a single command: 


TRIGger:MODe NORMal;:ACQuire:NUMAVg 16 


= If concatenated commands have headers that differ by only the 
last mnemonic, you can abbreviate the second command and 
eliminate the beginning colon. For example, the commands 
ACQuire:MODe AVErage and ACQuire:NUMAVg 16 could be 
concatenated into a single command: 


ACQuire:MODe AVErage; NUMAVg 16 

The longer version works equally well: 

ACQuire:MODe AVErage;:ACQuire:NUMAVg 16 
m Never precede a star (*) command with a colon: 

ACQuire:MODe AVErage;*TRG 


The instrument processes commands that follow the star 
command as if the star command was not there, so: 


ACQuire:MODe AVErage;*TRG;NUMAVg 16 


sets the acquisition mode to average and sets acquisition 
averaging to 16. The *TRG command is ignored. 


= When you concatenate queries, the responses to all queries are 
combined into a single response message. For example, if 
channel | coupling is set to DC and the bandwidth is set to 
20MHz, the concatenated query: 


CH1:COUP]ing?;BANdwidth? 


returns :CH1:COUPLING DC;:CH1:BANDWIDTH ON if header is on, 
or DC; ON if header is off. 


TDS 200-Series Programmer Manual 


Command Syntax 


m You can concatenate set commands and queries in the same 
message. For example: 


ACQuire:MO0De AVErage;NUMAVg?; STATE? 


is a valid message that sets the acquisition mode to normal, 
queries the number of acquisitions for averaging, and then queries 
the acquisition state. The oscilloscope executes concatenated 
commands and queries in the order it receives them. 


Here are some invalid concatenation examples: 


m (CH1:COUPling DC;ACQuire:NUMAVg 16 
(missing colon before ACQui re) 


m CH1:COUPling DC;:BANDwidth TWEnty 
(extra semicolon before BANDwi dth) 


m CH1:COUPling DC;:*TRG 
(extra colon before a star (*) command) 


m HORizontal:MAIn:POSition 0;MAIn:SCAle 1E-13 
(levels of mnemonics are different—either remove the second 
occurrence of MAIn:, or put :HORizontal: in front of 
MAIN: SCAle) 


@ Any query that returns arbitrary data, such as ID?, must be the 
last query when part of a concatenated command. If the query is 
not last, the oscilloscope generates event message 440. 


Message Terminators 


This manual uses the term <EQM> (End of message) to represent a 
message terminator. 


GPIB End of Message Terminators. GPIB EOM terminators can be the 
END message (EOI asserted concurrently with the last data byte), the 
ASCII code for line feed (LF) sent as the last data byte, or both. The 
oscilloscope always terminates messages with LF and EOI. White 
‘space is allowed before the terminator; for example, CR LF is 
acceptable. 
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RS-232 End of Message Terminators. RS-232 EOM terminators can be a 
CR (carriage return), LF (line feed), CRLF (carriage return followed 
by a line feed), or LFCR (line feed followed by a carriage return). 
When receiving, the oscilloscope accepts all four combinations as 
valid input message terminators regardless of the currently selected 
terminator. When a combination of multiple characters is selected 
(CRLF or LFCR), the oscilloscope interprets the first character as the 
terminator and the second character as a null command. 


Constructed Mnemonics 


Some header mnemonics specify one of a range of mnemonics. For 
example, a channel mnemonic can be either CH1 or CH2. You use 
these mnemonics in the command just as you do any other 
mnemonic. For example, there is a CH1: VOLts command and there is 
also a CH2: VOLts command. In the command descriptions, this list of 
choices is abbreviated CH<x>. 


Measurement Specifier Mnemonics 


Commands can specify which measurement to set or query as a 
mnemonic in the header. The instrument can display up to four 
automated measurements. The displayed measurements are specified 


in this way: 
Symbol Meaning 
MEAS<x> A measurement specifier; <x> is either 1[top], 2, 


3,0r 4. 


Channel Mnemonics 


Commands specify the channel to use as a mnemonic in the header. 


Meaning 


A channel specifier; <x> is either 1 or 2. 
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Reference Waveform Mnemonics 


Commands can specify the reference waveform to use as a 
mnemonic in the header. 


Meaning 
A reference waveform specifier; <x> is either A or B. 


REF<x> 


Cursor Position Mnemonic 
When the oscilloscope displays cursors, commands may specify 


which cursor of the pair to use. 


Meaning 
A cursor selector; <x> is either 1 or 2 


POSIT ION<x> 


Waveform Mnemonics 


In some commands you can specify a waveform without regard to its 
type: channel waveform, math waveform, or reference waveform: 


Meaning 
Can be CH<x>, MATH, or REF<x> 


Argument Types 
A command argument can be in one of several forms. The individual 
descriptions of each command tell which argument types to use with 
that command. 


Numeric Arguments 


Many oscilloscope commands require numeric arguments. There are 
three types of numeric argument: 
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Symbol Meaning 

<NR1> Signed integer value ) 
<NR2> Floating point value without an exponent 

<NR3> Floating point value with an exponent 


The syntax shown is the data format that the oscilloscope returns in 
response to a query. This format is also the preferred format when 
sending a command to the oscilloscope. 


When you enter an incorrect numeric argument, the oscilloscope 
automatically forces the numeric argument to a correct value. The 
following table lists how the oscilloscope handles incorrect numeric 
arguments. 


Argument value Oscilloscope response 


Numeric argument is Sets the specified command to the lowest correct 
less than lowest correct | value and executes the command 
value for that command 


Numeric argument is Sets the specified command to the highest correct 
greater than the highest | value and executes the command 

correct value for that 

command 


Numeric value is be- Rounds the entered value to the nearest correct 
tween two correct values | value and executes the command 


Quoted String Arguments 


Some commands accept or return data in the form of a quoted string, 
which is simply a group of ASCII characters enclosed by single 
quotes (') or double quotes ("). For example: 


"this is a quoted string" 


Meaning 
Quoted string of ASCII text 


<QString> 
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Follow these rules when you use quoted strings: 


1. 


A quoted string can include any character defined in the 7-bit 
ASCII character set. Refer to Appendix A. 


Use the same type of quote character to open and close the string: 
"this is a valid string" 


You can mix quotation marks within a string as long as you 
follow the previous rule: 


"this is an 'acceptable' string" 


You can include a quote character within a string simply by 
repeating the quote. For example, 


"here is a "" mark” 
Strings can have upper or lower case characters. 


If you use a GPIB network, you cannot terminate a quoted string 
with the END message before the closing delimiter. 


A Cafriage return or line feed embedded in a quoted string does 
not terminate the string, but is treated as just another character in 
the string. 


. The maximum length of a quoted string returned from a query is 


1000 characters. 


Here are some examples of invalid strings: 


"Invalid string argument ' 
(quotes are not of the same type) 


"test<EQI>" 
(termination character is embedded in the string) 
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Block Arguments 


Several oscilloscope commands use a block argument form. The 
following table describes each part of a block argument Figure 2-2 
shows an example of a block argument. 


Symbol Meaning 

<NZDig> A non-zero digit character, in the range 1-9 

<Dig> A digit character, in the range 0-9 

<DChar> A character with the hex equivalent of 00 through FF 
hexadecimal (0 through 255 decimal) 

<Block> A block of data bytes, defined as: 
<Block> ::= 


{ #<NZDig><Dig>[<Dig>...][<DChar>...] 
| #0[<DChar>...]<terminator> } 


Block argument 


*DDT #217ACQuire:STATE RUN 


Block header Specifies data length 


Specifies number of 
length digits that follow 


Figure 2-2: Block argument example 
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<NZDig> specifies the number of <Dig> elements that follow. Taken 
together, the <Dig> elements form a decimal integer that specifies 
how many <DChar> elements follow. 


#0 means that the <B] ock> is an indefinite length block. The 
<terminator> ends the block. You should not use indefinite length 
blocks with RS-232, because there is no way to include a <termina- 
tor> character as a <DChar> character. 


The first occurrence of a <terminator> character signals the end of 
the block and any subsequent <DChar> characters will be interpreted 
as a syntax error. With the GPIB, the EOI line signals the last byte. 
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This section lists the commands organized by functional group. The 
Command Descriptions section, starting on page 2-33, lists all 


commands alphabetically. 


The oscilloscope GPIB and RS-232 interfaces conform to Tektronix 
standard codes and formats except where noted. The GPIB interface 
also conforms to IEEE Std 488.2-1987 except where noted. 


Acquisition Commands 


Acquisition commands affect the acquisition of waveforms. These 
commands control mode, averaging, enveloping, and single-wave- 


form acquisition. 


Table 2-4: Acquisition Commands 


Header 

ACQuire? 
ACQuire:MODe 
ACQuire:NUMACg? 
ACQuire:NUMAVg 


ACQuire: STATE 
ACQuire: STOPAfter 
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Description 

Return acquisition parameters 
Set/query acquisition mode 
Return # of acquisitions obtained 


Set/query number of acquisitions for 
average 


Start or stop acquisition system 


Set/query acquisition control 
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Calibration and Diagnostic Commands 


Calibration and Diagnostic commands let you initiate the oscillo- 
scope self-calibration routines and examine the results of diagnostic 


tests. 


Table 2-5: Calibration and Diagnostic Commands 


Header 
*CAL? 


CALibrate: ABORT 
CALibrate: INTERNAL 
CALibrate:FACtory 


CALibrate: CONTINUE 


CALibrate: STATUS? 


DIAg: RESULT: FLAG? 
DIAg: RESULT :LOG? 


ERRLOG: FIRST? 
ERRLOG: NEXT? 
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Description 


Perform an internal self-calibration and 
return result status 


Stop an in-progress factory calibration 
Perform an internal self-calibration 


Initialize the factory calibration se- 
quence 


Perform the next step in the factory 
calibration sequence 


Return PASS or FAIL status of the last 
self- or factory-calibration operation 


Return diagnostic tests status 


Return diagnostic test sequence 
results 


Returns first entry from error log 


Returns next entry from error log 
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Command Groups 


Cursor commands provide control over the oscilloscope cursor 


display and readout. 


Table 2-6: Cursor Commands 


Header 
CURSor? 
CURSor:FUNCtion 


CURSor:HBArs? 
CURSor:HBArs:DELTa? 


CURSor: HBArs : POSIT ION<x> 


CURSor:HBArs:UNIts? 
CURSor:SELect:SOUrce 
CURSor: VBArs? 
CURSor:VBArs:DELTa? 


CURSor:VBArs: POSIT ION<x> 


CURSor:VBArs:UNIts 
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Description 
Returns cursor settings 


Set/query cursors on or off; select 
cursor type 


Return horizontal bar settings 


Return vertical distance between 
horizontal bar cursors 


Set/query position of a horizontal bar 
cursor 


Query vertical scale units 
Select waveform 
Return vertical bar settings 


Return horizontal distance between 
cursors 


Set/query position of a vertical bar 
cursor 


Set/query vertical cursors to time or 
frequency 
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Display Commands 


Display commands let you change the graticule style, displayed 
contrast, and alter other display attributes. 


Table 2-7: Display Commands 


Header Description 

DISplay? Returns display settings 

DISplay:FORMat Set/query YT or XY display 
Hard Copy Commands 


The hard copy commands let you control the format of hard copy 
output and control the starting and stopping of hard copies. 


Table 2-8: Hard Copy Commands 


Header Description 


HARDCopy Start or terminate hard copy 

HARDCopy: FORMat Set/query the hard copy output format 

HARDCopy: LAYout Set/query the hard copy orientation 

HARDCopy: PORT | Set/query the hard copy port for output 
(RS232, GPIB, or Centronics) 
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Horizontal Commands 


Horizontal commands control the time bases of the oscilloscope. 
You can set the position and time per division of both the main and 
window time bases. 


You can substitute SECdiv for SCAle in all appropriate horizontal 
commands. This provides program compatibility with previous 
Tektronix digitizing oscilloscopes. 


Table 2-9: Horizontal Commands 


Header Description 
HORizontal? Return horizontal settings 


HORizontal :DELay:POSition Position window 


HORizontal :DELay:SCAle Set/query window time base time/divi- 
sion 

HORizontal:DELay:SECdiv Same as HORizontal:DELay:SCAle 

HORizontal :MAIn Set/query main time base time/division 

HORizontal :MAIn:POSition Set/query main time base trigger point 

HORi zontal :MAIn:SCAle Set/query main time base time/division 

HORizontal :MAIn:SECdiv Same as HORizontal:MAIn:SCAle 

HORi zontal :POSition Set/query position of waveform to 
display 

HORi zontal :RECOrdlength Return waveform record length 

HORizontal:SCAle Same as HORizontal:MAIn:SCAle 

HORizontal :SECdiv Same as HORizontal:MAIn:SCAle 

HORizontal:VIEw Select view 

MATH: FFT :HORizontal Set/query 

:POSition (TDS2MM Only) 

MATH: FFT: HORizontal Set/query 

:SCAle (TDS2MM Only) 


TDS 200-Series Programmer Manual 2-19 


Command Groups 


Measurement Commands 
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Measurement commands control the automated measurement 
system. Up to four automated measurements can be displayed on the 
oscilloscope screen. In the commands, these four measurement 
readouts are named MEAS<x>, where <x> can be 1, 2, 3, or 4. 


In addition to the four measurement readouts displayed, the 
measurement commands let you specify a fifth measurement, IMMed. 
The immediate measurement has no front-panel equivalent, and the 
instrument never displays immediate measurements. Because they 
are computed only when they are requested, immediate measure- 
ments slow the waveform update rate less than displayed measure- 
ments. 


Use the VALue? query to obtain measurement results of either 
displayed or immediate measurements. 


Several measurement commands set and query measurement 
parameters. You can assign some parameters, such as waveform 
sources, differently for each measurement readout. 


Table 2-10: Measurement Commands 


Header Description 

MEASUrement? Return all measurement parameters 

MEASUrement : IMMed? Return immediate measurement 
parameters 

MEASUrement : IMMed: SOUrce Set/query channel to take the immedi- 
ate measurement from 

MEASUrement : IMMed:TYPe Set/query the immediate measure- 
ment to be taken 

MEASUrement : IMMed: UNI ts? Return the immediate measurement 
units 

MEASUrement : IMMed: VALue? Return the immediate measurement 
result 

MEASUrement :MEAS<x>? Return parameters on the periodic 
measurement 
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Table 2-10: Measurement Commands (Cont.) 


Header 
MEASUrement :MEAS<x>:SOUrce 


MEASUrement :MEAS<x>:TYPe 
MEASUrement :MEAS<x>:UNIts? 


MEASUrement :MEAS<x>: VALue? 


Miscellaneous Commands 


Description 


Set/query channel to take the periodic 
measurement from 


Set/query the type of periodic 
measurement to be taken 


Returns the units for periodic 
measurement 


Returns periodic measurement results 


Miscellaneous commands are a group of commands that do not fit 


into any other category. 


Several commands and queries are common to all 488.2-1987 
devices on the GPIB BUS and the device on the RS-232 interface. 
These commands and queries are defined by IEEE Std. 488.2-1987 
and Tek Standard Codes and Formats 1989 and begin with an 


asterisk (*) character. 


Table 2-11: Miscellaneous Commands 


Header 
AUTOSet 
*DDT 
FACtory 
HDR 
HEADer 
ID? 
*IDN? 
LANGUAGE 
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Description 

Automatic instrument setup 

Set/query group execute trigger (GET) 
Reset to factory default 

Same as HEADer 

Set/query command header 

Returns identification information 
Returns identification information 


Set/query language for display 
messages 


2-21 


Command Groups 


Table 2-11: Miscellaneous Commands (Cont.) 


Header 
LOCk 
*LRN? 


Description 
Lock front panel (local lockout) 


Query device settings 


REM 
RSL 
SER? 
*TRG 
SEOTE 
UNLock 
VERBos 


RS-232 Commands 


RS-232 commands allow you to set or query the parameters that 
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control the RS-232 port. 


Table 2-12: RS-232 Commands 


RS232? 

RS232:BAUd 
RS232:HARDF1agging 
RS232:PARity 
RS232:SOFTFlagging 
RS232:TRANsmit:TERMinator 


No action; remark only 

Reset 

Same as “LRN? 

Perform Group Execute Trigger (GET) 
Return self-test results 

Unlock front panel (local lockout) 


Set/query full command name or 
minimum spellings for query 
responses 


Query RS232 parameters 
Set/query baud rate 
Set/query hard flagging 
Set/query parity type 
Set/query soft flagging 


Set/query end-of-line terminator 
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Save and Recall Commands 


Save and Recall commands allow you to store and retrieve internal 
waveforms and settings. When you “save a setting,” you save most 
of the settings of the oscilloscope. When you then “recall a setting,” 
the oscilloscope restores itself to the state it was in when you saved 
that setting. 


To display a saved waveform, use the SELect:<wfm> command 
described on page 2-138. 


Table 2-13: Save and Recall Commands 


Header Description 

*ROE Recall setting 

RECAI1:SETUp Recall saved instrument setting 
*SAV Save instrument setting 
SAVe:SETUp save instrument setting 
SAVe:WAVEform Save waveform 


Status and Error Commands 


Status and error commands let you determine the status of the 
oscilloscope and control events. 


Several commands and queries are common to all devices on the 
GPIB bus. These commands and queries are defined by IEEE Std. 
488.2-1987 and Tek Standard Codes and Formats 1989, and begin 
with an asterisk (*) character. 


Table 2-14: Status and Error Commands 


Header Description 


ALLEv? 


Return all events 


Return instrument busy status 


Clear status 
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Table 2-14: Status and Error Commands (Cont.) 


Header Description 

DESE Set/query device event status enable 

*ESE Set/query standard event status 
enable 

*ESR? Return standard event status register 

EVENT? Return event code 

EVMsg? Return event message 

EVQty? Return number of events in queue 

*OPC Set/query operation complete 

*PSE Set/query power-on status clear 

*SRE Set/query service request enable 

*STB? Read status byte 

*WAI Wait to continue 


Trigger Commands 


Trigger commands control all aspects of oscilloscope triggering. 


The two types of triggers are edge and video. Edge triggering is the 
default type. Edge triggering lets you acquire a waveform when the 
signal passes through a voltage level of your choosing. Video 

triggering adds the capability of triggering on video fields and lines. 


Table 2-15: Trigger Commands 


Header Description 
TRIGger Force trigger event 
TRIGger:MAIn Set main trigger level to 50%; Query 


returns main trigger settings 


TRIGger :MAIn: EDGE? Return edge trigger settings 
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Table 2-15: Trigger Commands (Cont.) 


Header 
TRIGger:MAIn: EDGE: COUP] ing 
TRIGger:MAIn:EDGE:SLOpe 


Description 
Set/query edge trigger coupling 


Set/query edge trigger slope 


TRIGger:MAIn: EDGE: SOUrce 
TRIGger:MAIn:HOLDOF f? 
TRIGger:MAIn:HOLDOff:VALue 
TRIGger:MAIn:LEVel 
TRIGger:MAIn:MODe 
TRIGger:MAIn: TYPe 
TRIGger:MAIn:VIDeo? 
TRIGger:MAIn:VIDeo: POLarity 
TRIGger:MAIn:VIDeo:SOUrce 
TRIGger:MAIn:VIDeo:SYNC 
TRIGger: STATE? 


Vertical Commands 


Set/query edge trigger source 
Return trigger holdoff value 
Set/query trigger holdoff value 
Set/query trigger level 
Set/query trigger mode 
Set/query main trigger type 
Query video trigger parameters 
Set/query video trigger polarity 
Set/query video trigger source 
Set/query video trigger sync 


Return trigger system status 


Vertical commands control the attributes of CH1 and CH2. The 
SELect:<wfm> command also displays or removes from display a 


specified waveform. 


Table 2-16: Vertical Commands 


Header 

CH<x>? 

CH<x>:BANdwidth 
CH<x>:COUPI ing 
CH<x>:INVert (TDS2MM Only) 
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Description 
Return vertical parameters 


Set/query channel bandwidth 
Set/query channel coupling 


Set/query channel invert 
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Table 2-16: Vertical Commands (Cont.) 


Header Description 

CH<x>:POSition Set/query channel position 

CH<x>: PRObe Set/query channel probe parameters 
CH<x>:SCAle Set/query channel volts/div 
CH<x>:VOLts Same as CH<x>:SCAle 

MATH? Query math waveform state 

MATH: DEFINE Set/query math waveform definition 
MATH: FFT: VERtical Set/query FFT waveform vertical 
:POSition (TDS2MM Only) position 

MATH: FFT: VERtical Set/query FFT waveform vertical scale 
:SCAle (TDS2MM Only) 

SELect :<wfm> Set/query waveform display state 


Waveform Commands 
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Waveform commands let you transfer waveform data points to and 
from the oscilloscope. Waveform data points are a collection of 
values that define a waveform. One data value usually represents one 
data point in the waveform record. When working with peak-detect 
waveforms, each data value is either the min or max of a min/max 
pair. Before you can transfer waveform data, you must specify the 
data format and waveform locations. 


Refer to the text following this table for more information about 
waveform commands. 


Table 2-17: Waveform Commands 


Description 


Transfer waveform data to or from the 
instrument 


Set/query the waveform data format 
and location 
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Table 2-17: Waveform Commands (Cont.) 


Header 
DATa:DESTination 


DATa:ENCdg 


DATa:SOUrce 
DATa:STARt 


DATa: STOP 


DATa: TARget 
DATa:WIDth 


WAVFrm? 


WFMPre? 
WFMPre:BIT Nr 


WFMPre:BN_ Fmt 
WFMPre:BYT Nr 


WFMPre:BYT Or 


Description 


Set/query the destination for wave- 
forms sent to the oscilloscope 


Set/query the waveform data encoding 
method 


Set/query the source of CURVe? data 


Set/query the starting point in wave- 
form transfer 


Set/query the ending point in wave- 
form transfer 


Same as DATa:DESTination 


Set/query the byte width of waveform 
points 


Returns waveform preamble and 
curve data 


Returns waveform preamble 


Set/query the preamble bit width of 
waveform points 


Set/query the preamble binary encod- 
ing type 

Set/query the preamble byte width of 
waveform points 


Set/query the preamble byte order of 
waveform points 


WFMPre:ENCdg .- 
WFMPre:NR_Pt 


WFMPre:PT_Fit 
WFMPre:PT_Off 
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Set/query the preamble encoding 
method 


Query the number of points in the 
curve transfer 


Set/query the format of curve points 


Query the trigger offset 
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Table 2-17: Waveform Commands (Cont.) 


Header 
WFMPre: 
WFMPre: 


WFMPre: 
WFMPre: 


WFMPre: 
WFMPre: 


WFId? 
XINcr 


XUNit 
XZEro 


YMUI t 
YOFf 


WFMPre: 
WFMPre: 
WFMPre: 
WFMPre: 
WFMPre: 
WFMPre: 
WFMPre: 


YUNit 

YZEro? 
<wfm>? 
<wfm>: 
<wfm>: 
<wfm>: 


<wfm: 


PT Fmt 
PT Off? 
WFId? 
XINcr 


Description 
Query the waveform identifier 


Set/query the horizontal sampling 
interval 


Set/query the horizontal units 


Set/query time of first point in wave- 
form 


Set/query the vertical scale factor 
Set/query the vertical offset 
Set/query the vertical units 

Query the 0 dB level (TDS2MM Only) 
Returns waveform formatting data 
Set/query the format of curve points 
Query the trigger offset 

Query the waveform identifier 


Set/query the horizontal sampling 
interval 


WFMPre: 


<wfm>: 


XUNit 


WFMPre: 


WFMPre: 
WFMPre: 
WFMPre: 
WFMPre: 


<wfm>: 


<wfm> 
<wfm>: 
<wfm>: 


<wfm>: 


XZEro 


> YMU1t 
: YOFf 


YUNit 
YZEro? 


Set/query the horizontal units 


Set/query the time of first datapoint in 
waveform 


Set/query the vertical scale factor 
Set/query the vertical position 
Set/query the vertical units 

Query the 0 dB level (TDS2MM Only) 
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Waveform Data Formats 


Waveform data uses one 8-bit data byte to represent each data point, 
regardless of the acquisition mode. 


For compatibility with earlier digitizing oscilloscopes, the 
DATa:WIDth command lets you specify the number of bytes per data 
point when transferring data to and from the oscilloscope. If you 
specify two bytes for data that uses only one, the least significant 
byte will be filled with zeros. The oscilloscope ignores the 
least-significant byte of incoming waveforms. 


The oscilloscope can transfer waveform data in either ASCII or 
binary format. Use the DATa:ENCdg command to specify one of the 
following formats: 


= ASCII data is represented by signed integer values. The range of 
values depends on the byte width specified. One-byte-wide data 
ranges from —128 to 127. Two-byte-wide data ranges from 
—32768 to 32767. 


Each data value requires two to seven characters. This includes 
one character for the minus sign if the value is negative, one to 
five ASCII characters for the waveform value, and a comma to 
separate data points. 


An example of an ASCII waveform data string follows: 


CURVE<space>-110,-109,-110,-110,-109,-107,-109,-107, 
=106,=105,~7103;-100,-97 ,-90,-84,-80 
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= Binary data can be represented by signed integer or positive 
integer values. The range of the values depends on the byte width 
specified. Table 2-18 lists the ranges for one- and two-byte-wide 
data. 


Table 2-18: Binary data ranges 


Byte width | Signed integer range Positive integer range 


The defined binary formats also specify the order in which the 
bytes are transferred giving a total of four binary formats: 
RIBinary, RPBinary, SRIbinary, and SRPbinary. 


RIBinary is signed integer where the most significant byte is 
transferred first, and RPBinary is positive integer where the most 
significant byte is transferred first. SRIbinary and SRPbinary 
correspond to RIBinary and RPBinary respectively but use a 
swapped byte order where the least significant byte is transferred 
first. The byte order is ignored when DATa:WIDth is set to 1. 


Waveform Data Record 


You can transfer multiple points for each waveform record. You can 
transfer a portion of the waveform or you can transfer the entire 
record. The DATa:STARt and DATa:STOP commands let you specify 
the first and last data points of the waveform record. 


When transferring data into the oscilloscope you must specify the 
location of the first data point within the waveform record. For 
example, when DATa:STARt is set to 1, data points will be stored 
starting with the first point in the record, and when DATa:STARt is 
set to 500, data will be stored starting at the 500" point in the record. 
The oscilloscope ignores DATa:STOP when reading in data as the 
oscilloscope will stop reading data when there is no more data to 
read or when it has reached 2500 data points. 
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You must specify the first and last data points in the waveform 
record when transferring data from the oscilloscope to an external 
device. Setting DATa:STARt to 1 and DATa:STOP to 2500 always 
sends the entire waveform, regardless of the acquisition mode. 


Waveform Data Locations and Memory Allocation 


The DATa:SOUrce command specifies the location of the data when 
transferring waveforms from the oscilloscope. You can transfer one 
waveform at a time. 


You can transfer only one waveform into the oscilloscope at a time. 
Each waveform sent to the oscilloscope is stored in one of two stored 
waveform locations. You specify the stored waveform location with 
the DATa:DESTination command. 


NOTE. The oscilloscope accepts waveforms that are = 2500 data 
points long. The oscilloscope truncates waveforms longer than 2500 
data points. 


Waveform Preamble 


Each waveform that is transferred has an associated waveform 
preamble that contains information such as the horizontal scale, 
vertical scale, and other settings in place when the waveform was 
created. Refer to the WFMPre commands starting on page 2—158 for 
more information about the waveform preamble. 


Scaling Waveform Data 


Once you transfer the waveform data to the controller, you can 
convert the data points into voltage values for analysis using 
information from the waveform preamble. 
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Transferring Waveform Data From the Oscilloscope 


Data transfer times depend on data format data width and the speed 
of the controller. To transfer waveforms from the oscilloscope to an 
external controller, do the following steps. 


1. Use the DATa:SOUrce command to select the waveform source. 


2. Use the DATa:ENCdg command to secify the waveform data 
format. 


3. Use the DATa:WIDth command to specify the number of bytes 
per data point. 


4. Use the DATa:STARt and DATa:STOP commands to specify the 
portion of the waveform that you want to transfer. 


5. Use the WFMPRe? command to transfer waveform preamble 
information. 


6. Use the CURVe? command to transfer waveform data. 


Transferring Waveform Data To the Oscilloscope 


To transfer waveform data to one of two oscilloscope waveform 
storage locations, do the following steps: 


1. Use the DATa:DESTination command to specify the stored 
waveform location. 


2. Use the DATa:ENCdg command to specify the waveform data 
format. 


3. Use the DATa:WIDth command to specify the number of bytes 
per data point. 


4. Use the DATa:STARt command to specify the first data point in 
the waveform record. 


5. Use the WFMPRe command to transfer waveform preamble 
information. 


6. Use the CURVe command to transfer waveform data. 
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Commands either set or query oscilloscope values. Some commands 
both set and query, some only set, and some only query. This manual 
marks set-only commands with the words “No Query Form.” It 
marks query-only commands with a question mark appended to the 
command and the words “Query Only” in the command name. 


The TDS2MM Measurement Extension Module adds or changes 
some program commands. New or changed TDS2MM commands are 
marked with the words “TDS2MM Only” or ”>TDS2MM Version”’. 


This manual fully spells out headers, mnemonics, and arguments 
with the minimal spelling shown in upper case. For example, to use 
the abbreviated form of the ACQuire:MODe command just type 
ACQ:MOD. 


NOTE. While trigger view is active (by pushing the TRIGGER VIEW 
button on the front panel), the oscilloscope ignores the set form of 
most commands. If you send a command at this time the oscilloscope 
generates execution error 221 (Settings conflict). 


ACQuire? (Query Only) 


Returns all the current acquisition parameters. 


Group 
Acquisition 


Syntax 
ACQuire? 


Returns 
Returns current acquisition parameters 
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Examples 

ACQUIRE? 

might return the string :ACQUIRE: STOPAFTER RUNSTOP; STATE 
1;MODE SAMPLE;NUMAVG 16 for the current acquisition parameters. 


Related Commands 
None 


ACQuire:MODe 


Sets or queries the oscilloscope acquisition mode. This affects all 
live waveforms. This command is equivalent to setting Mode in the 
Acquire menu. 


Waveforms are the displayed data point values taken from acquisi- 
tion intervals. Each acquisition interval represents a time duration 
that is determined by the horizontal scale (time per division). 


The oscilloscope sampling system can operate at a rate greater than 
that indicated by the horizontal scale. Therefore an acquisition 
interval can include more than one sample. 


The acquisition mode, which you set using this ACQuire:MODe 
command, determines how the final value of the acquisition interval 
is generated from the many data samples. 


Group 
Acquisition 


Syntax 
ACQuire:MODe { SAMple | PEAKdetect | AVErage } 


ACQuire:MODe? 


Arguments 

SAMp1e specifies that the displayed data point value is the first 
sampled value that was taken during the acquisition interval. The 
waveform data has 8 bits of precision in all acquisition modes. You 
can request 16 bit data with a CURVe? query, but the lower-order 8 
bits of data will be zero. SAMp1e is the default mode. 
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PEAKdetect specifies the display of the high-low range of the 
samples taken from a single waveform acquisition. The oscilloscope 
displays the high-low range as a vertical range that extends from the 
highest to the lowest value sampled during the acquisition interval. 
PEAKdetect mode can reveal the presence of aliasing. 


AVErage specifies averaging mode, where the resulting waveform 
shows an average of SAMp1e data points from several separate 
waveform acquisitions. The number of waveform acquisitions that go 
into making up the average waveform is set or queried using the 
ACQuire:NUMAV¢g command. 


Examples 

ACQUIRE:MODE PEAKdetect 

displays a vertical area representing the range of the highest to 
lowest value of the acquired signal. 


ACQUIRE:MODE? 
might return SAMPLE. 


Related Commands 
ACQuire:NUMAVg, CURVe?, DATa: WIDth 


ACQuire:NUMACq? (Query Only) 


Indicates the number of acquisitions that have taken place since 
starting oscilloscope acquisition. The maximum number of 
acquisitions that can be counted is 23!—1. This value is reset to zero 
when you change any Acquisition, Horizontal, Vertical, or Trigger 
arguments that affect the waveform, with the following exceptions: 


m Changing the vertical position, trigger level, or trigger holdoff 
when in Sample or Peak Detect mode does not reset the value to 
zero. 


= Changing the vertical scale during Scan does not reset the value 
to zero. 
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Note that any change made when in Average mode aborts the 
acquisition and resets ACQuire: NUMACgq to zero. 


Group 


Acquisition 


Syntax 
ACQuire:NUMACq? 


Returns 
<NR1> 


Examples 

ACQUIRE: NUMACQ? 

might return 350, indicating that 350 acquisitions took place since an 
ACQUIRE:STATE RUN command was executed. 


Related Commands 
ACQuire:STATE 


ACQuire:NUMAVg 


Sets the number of oscilloscope waveform acquisitions that make up 
an averaged waveform. This command is equivalent to setting the 
Average count in the Acquire menu. 


Group 
Acquisition 


Syntax 
ACQuire:NUMAVg <NR1> 


ACQui re: NUMAVg? 
Arguments 


<NR1> is the number of waveform acquisitions. Correct values are 4, 
16, 64, and 128. 
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Examples 

ACQUIRE:NUMAVG 16 

specifies that an averaged waveform will show the result of 
combining 16 separately acquired waveforms. 


ACQUIRE: NUMAVG? 
might return 64, indicating that there are 64 acquisitions specified for 
averaging. 


Related Commands 
ACQuire:MODe 


ACQuire:STATE 


Starts or stops oscilloscope acquisitions. This command is the 
equivalent of pressing the front-panel RUN/STOP button. If 
ACQuire:STOPAfter is set to SEQuence, other signal events may 
also stop acquisition. 


NOTE. The best way to determine when a single sequence acquisition 
is complete is to use *OPC? instead of ACQuire:STATE?. 


Group 
Acquisition 


Syntax 
ACQuire:STATE { OFF | ON | RUN | STOP | <NRI> } 


ACQuire: STATE? 


Arguments 
OFF or STOP or <NR1> = 0 stops acquisitions. 


ON or RUN or <NR1> 0 starts acquisition and display of waveforms. 
If the command was issued in the middle of an acquisition sequence 
(for instance averaging or enveloping), RUN restarts the sequence, 
discarding any data accumulated before the STOP. It also resets the 
number of acquisitions. 
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. Examples 


ACQUIRE: STATE RUN 
starts acquisition of waveform data and resets the number of 
acquisitions count (NUMAC4q) to zero. 


ACQUIRE: STATE? 
returns either 0 or 1, depending on whether the acquisition system is 
running. 


Related Commands 
ACQuire:NUMACq?, ACQuire:STOPAfter, *OPC? 


ACQuire:STOPAfter 
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Tells the oscilloscope when to stop taking acquisitions for edge 
trigger type. 


Group 
Acquisition 


Syntax 
ACQuire:STOPAfter { RUNSTop | SEQuence} 


ACQuire:STOPAf ter? 


Arguments 


RUNSTop specifies that the run and stop state should be determined by 
the user pressing the front-panel RUN/STOP button. 


SEQuence specifies “single sequence” operation, where the 
oscilloscope stops after it has acquired enough waveforms to satisfy 
the conditions of the acquisition mode. For example, if the 
acquisition mode is set to sample, the oscilloscope stops after 
digitizing a waveform from a single trigger event. However, if the 
acquisition mode is set to average 64 waveforms, then the oscillo- 
scope stops only after acquiring all 64 waveforms. The ACQuire: 
STATE command and the front-panel RUN/STOP button also stop 
acquisitions when the oscilloscope is in single sequence mode. 
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Examples 

ACQUIRE: STOPAFTER RUNSTop 

sets the oscilloscope to stop acquisition when the user presses the 
front-panel RUN/STOP button. 


ACQUIRE: STOPAFTER? 
might return SEQUENCE. 


Related Commands 
ACQuire:MODe, ACQuire:STATE 


ALLEv? (Query Only) 


Causes the oscilloscope to return all events and their messages, and 
removes the returned events from the Event Queue. The messages 
are separated by commas. Use the *ESR? query to enable the events 
to be returned. For a complete discussion of the use of these 
registers, see page 3-1. This command is similar to repeatedly 
sending *EVMsg? queries to the instrument. 


Group 
Status and error 


Syntax 
ALLEv? 


Returns 
The event code and message in the following format: 


<Event Code><Comma><QString>[<Comma><Event 
Code><Comma><QString>...] 


<QString>::= <Message>; [<Command>] 


<Command> is the command that caused the error and may be 
returned when a command error is detected by the oscilloscope. As 
much of the command is returned as possible without exceeding the 
60 character limit of the <Message> and <Command> strings 
combined. The command string is right-justified. 
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Examples 

ALLEV? 

might return the string :ALLEV 2225,"Measurement error, No 
waveform to measure; ",420,"Query UNTERMINATED; ". 


Related Commands 
*CLS, DESE, *ESE, *ESR?, EVENT?, EVMsg?, EVQty?, *SRE, 
ESTE 


AUTOSet (No Query Form) 


Causes the oscilloscope to adjust its vertical, horizontal, and trigger 
controls to display a stable waveform. This command is equivalent to 
pushing the front-panel AUTOSET button. 


For a detailed description of the autoset function, refer to the 
TDS 210 & TDS 220 User Manual. 


Group 
Miscellaneous 


Syntax 
AUTOSet { EXECUTE } 


Arguments 
EXECute autosets the displayed waveforms. 


BUSY? (Query Only) 


2-40 


Returns the status of the oscilloscope. This command allows you to 
synchronize the operation of the oscilloscope with your application 
program. Synchronization methods are described on page 3-10. 


Group 
Status and error 


Syntax 
BUSY? 
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Returns 


0 means that the oscilloscope is not busy processing any of the 
commands listed in Table 2-19. 


1 means that the oscilloscope is busy processing one of the 
commands listed in Table 2-19. 


Table 2-19: Commands that Affect BUSY? Response 


Operation Command 

Single sequence acquisition | ACQuire:STATE ON or 
ACQuire:STATE RUN 
(when ACQuire:STOPAfter is set to SE- 
Quence) 

Hard copy output HARDCopy STARt 


Signal path compensation *CAL?, CALibrate: CONTINUE, 
CALibrate:FACtory, CALibrate: INTERNAL 


Examples 
BUSY? 
might return 1, indicating that the oscilloscope is busy. 


Related Commands 
*OPC, *WAI 
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*CAL? (Query Only) 


Performs an internal self-calibration and returns its status. This is 
equivalent to selecting Do Self Cal in the Utility menu. Although 
*CAL? is a query command, it does perform an action. 


NOTE. The self-calibration can take several minutes to complete. The 
oscilloscope does not execute any commands until the self-calibra- 
tion is complete. 


Group 
Calibration and Diagnostic 


Syntax 
*CAL? 


Returns 


0 indicates that the self-calibration completed without any errors 
detected. 


Any value other than zero indicates that the self-calibration did not 
complete successfully or completed with errors. 


Examples 

*CAL? 

performs a self-calibration and might return 0 to indicate that it 
completed successfully. 


Related Commands 
CALibrate: INTERNAL, CALibrate:STATUS? 
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CALibrate: ABORT (No Query Form) 


NOTE. This command should only be used in a qualified service 
environment. For more information about the factory calibration 
sequence, refer to the TDS210 & TDS 220 Service Manual. 


Aborts the factory calibration process. When you abort the factory 
calibration, the oscilloscope restores the calibration settings to the 
previous factory calibration constants stored in non-volatile memory. 


Group 
Calibration and Diagnostic 


Syntax 
CALi brate: ABORT 


Examples 

CALibrate: ABORT 

stops the in-process factory calibration procedure. 
Related Commands 


CALibrate: CONTINUE, CALibrate:FACTory, CALibrate: INTER- 
NAL, CALibrate:STATUS? 


CALibrate: CONTINUE (No Query Form) 


NOTE. This command should only be used in a qualified service 
environment. For more information about the factory calibration 
sequence, refer to the TDS210 & TDS 220 Service Manual. 


Performs the next step in the factory calibration operation. 


Group 
Calibration and Diagnostic 
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Syntax 
CALibrate: CONTINUE 


Examples 
CALibrate: CONTINUE 
performs the next step in the factory calibration operation. 


Related Commands 


*CAL?, CALibrate: ABORT, CALibrate:FACTory, 
CALibrate: INTERNAL, CALibrate:STATUS? 


CALibrate:FACTory (No Query Form) 


NOTE. This command should only be used in a qualified service 
environment. For more information about the factory calibration 
sequence, refer to the TDS210 & TDS 220 Service Manual. 


Starts the oscilloscope’s internal factory calibration operation. The 
calibration operation consists of a sequence of steps. You send the 
CALibrate:; CONTINUE command to advance to the next calibration 
step. The calibration program automatically sets up the oscilloscope 
for each calibration step. Use the CALibrate:ABORT command to 
abort the factory calibration. 


You can only send synchronization commands or queries (such as 
*OPC, OPC?, *WAI, BUSY?) while doing a factory calibration. 


Group 
Calibration and Diagnostic 


Syntax 
CALibrate:FACTory 
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Examples 
CALibrate:FACTory 
starts the factory calibration process. 


Related Commands 


*CAL?, CALibrate: ABORT, CALibrate: CONTINUE, CALibrate:IN- 
TERNAL, CALibrate:STATUS? 


CALibrate: INTERNAL (No Query Form) 


Performs an internal self-calibration but does not return any status. 
This is equivalent to selecting Do Self Cal in the Utility menu. 


NOTE. The self-calibration can take several minutes to complete. The 
oscilloscope does not execute any commands until the self-calibra- 
tion is complete. 


Group 
Calibration and Diagnostic 


Syntax 
CALibrate: INTERNAL 


Examples 
CALibrate: INTERNAL 
performs an internal self-calibration. 


Related Commands 


*CAL?, CALibrate: ABORT, CALibrate: CONTINUE, 
CALibrate:FACTory, CALibrate: STATUS? 
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CALibrate:STATUS? (Query Only) 


Returns the status of the last calibration operation performed (either 
self- or factory-calibration). 


Group 
Calibration and Diagnostic 


Syntax 
CALibrate:STATUS? 


Returns 


PASS indicates that the oscilloscope completed the last calibration 
operation without detecting any errors. 


FAIL indicates that the oscilloscope detected errors during the last 
calibration operation. 


Examples 

CALibrate: STATUS? 

might return CALIBRATE:STATUS FAIL if the oscilloscope failed the 
last calibration operation. 


Related Commands 


*CAL?, CALibrate: ABORT, CALibrate: CONTINUE, 
CALIbrate:FACTory, CALibrate: INTERNAL 


CH<x>? (Query Only) 


Returns the oscilloscope vertical parameters. Because CH<x>:SCAle 
and CH<x>:VOLts are identical, only CH<x>:SCAle is returned. 


Group 
Vertical 


Syntax 
CH<x>? 
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Returns 
Oscilloscope vertical parameters 


Examples 

CH1? 

might return the string :CH1:SCALE 1.0E0;POSITION 0.0E0; 
COUPLING DC;BANDWIDTH FULL;PROBE 1.0E0 

for channel 1. 


Related Commands 
None 


CH<x>:BANdwidth 


Sets or queries the bandwidth setting of the specified oscilloscope 
channel. This command is equivalent to setting BW Limit in the 
Vertical menu. 


Group 
Vertical 


Syntax 
CH<x>:BANdwidth { ON | OFF } 


CH<x>:BANdwidth?. 


Arguments 
ON sets the channel bandwidth to 20 MHz. 


OFF sets the channel bandwidth to the full bandwidth of the 
oscilloscope. In most acquisition modes, full bandwidth is 60MHz or 
100MHz (depending on the oscilloscope model). There are two 
exceptions. At vertical scales of Smv/div or less (sensitivity at the 
BNC; that is, after the probe factor is removed), the full bandwidth is 
20MHz. When the acquisition mode is Peak Detect, and the vertical 
scale at the BNC is 10mv/div or less, the full bandwidth is also 
20MHz. 
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Examples 
CH2:BANDWIDTH ON 
sets the bandwidth of channel 2 to 20 MHz. 


CH1:BANDWIDTH? 
might return OFF, which indicates that there is no bandwidth limiting 
on channel 1. 


Related Commands 
None 


CH<x>:COUPling 


Sets or queries the input attenuator coupling setting of the specified 
oscilloscope channel. This command is equivalent to setting 
Coupling in the Vertical menu. 


Group 
Vertical 


Syntax 
CH<x>:COUPLing { AC | DC | GND } 


CH<x>:COUP1 ing? 
Arguments 
AC sets the specified oscilloscope channel to AC coupling. 


DC sets the specified oscilloscope channel to DC coupling. 


GND sets the specified oscilloscope channel to ground. Only a flat 
ground-level waveform is displayed. 
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Examples 


CH1:COUPLING AC 
establishes AC coupling on channel 1. 


CH2: COUPLING? 
might return DC, indicating that channel 2 is set to DC coupling. 


CH<x>:INVert (TDS2MM Only) 


Sets or queries the inversion state of the specified oscilloscope 
channel. The TDS2MM Module moves the channel invert function 
from the MATH menu to the Vertical CH1 and CH2 menus. This 
command is equivalent to setting Invert in the Vertical channel 
menus. 


The TDS2MM Module does not have the CH1-CH2 and CH2-CH1 
math functions. To do the same functions, invert the channel you 
want to subtract (using the CH1 or CH2 Vertical menu) and then 
select the CH1+CH2 math function. 


TDS2MM channel 
subtraction 


CH1+(-CH2) 
(-CH1)4+CH2 


Default channel 
subtraction 


CH1-CH2 
CH2-CH1 


Comments 


(-CH2) means invert channel 2 


(—CH1) means invert channel 1 


Group 
Vertical 


Syntax 
CH<x>:INVert { ON | OFF | <NRI1> } 


CH<x>:INVert? 


Arguments 
ON or <NR1>=1 inverts the specified oscilloscope channel. 


OFF or <NR1>=0 sets the specified oscilloscope channel to 
non-inverted. 
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_ Examples 


CH1: INVERT ON 
inverts the signal on channel 1. 


CH2: INVERT? 
might return 0, indicating that channel 2 is not inverted. 


Related Commands 
None 


CH<x>:POSition 
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Sets or queries the vertical position of the specified oscilloscope 
channel. The position voltage value is applied to the signal before 
digitization. This command is equivalent to adjusting the front-panel 
VERTICAL POSITION knob. 


Group 
Vertical 


Syntax 
CH<x>:POSition <NR3> 


CH<x>:POSition? 
Arguments 


<NR3> is the position in divisions from the center graticule. 
The range of positions is listed in Table 2-20. 


Table 2-20: Vertical position ranges using a 
1x probe 


CH<x>:SCAle 
2 mV/div 


5 mV/div 
10 mV/div 
20 mV/div 
50 mV/div 


Position range 
+1000 divs 


+400 divs 
+400 divs 
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Table 2-20: Vertical position ranges using a 
1x probe (Cont.) 


CH<x>:SCAle 
100 mV/div 
200 mV/div 
500 mV/div 
1 Vidiv 
2 Vidiv 
5 Vidiv 


Position range 


+100 divs 
+100 divs 
+100 divs 


+10 divs 


Examples 


CH2:POSITION 1.3E+00 
positions the channel 2 input signal 1.3 divisions above the center of 
the display. 


CH1:POSITION? 
might return -1.3E+00, indicating that the current position of 
channel 1 is at -1.3 divisions. 


Related Commands 
None 
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CH<x>:PRObe 


Sets or queries the attenuation factor of the specified channel. 


Group 
Vertical 


Syntax 

CH<x>:PRObe { 1 | 10 | 100 | 1000 } 

CH<x>:PRObe? 

Arguments 

1 sets the specified oscilloscope channel to x1 attenuation. 

10 sets the specified oscilloscope channel to x10 attenuation. 

100 sets the specified oscilloscope channel to x100 attenuation. 
1000 sets the specified oscilloscope channel to x1000 attenuation. 


Returns 
<NRI> 


Examples 
CH2:PROBE 1000 
sets channel 2 to x1000 attenuation. 


CH1:PRObe? 
might return CH1:PROBE 10. 


Related Commands 
None 
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CH<x>:SCAle 


Sets or queries the vertical gain of the specified oscilloscope 
channel. This command is equivalent to adjusting the front-panel 
VOLTS/DIV knob. 


Group 
Vertical 


Syntax 
CH<x>:SCAle <NR3> 


CH<x>:SCAle? 


Arguments 


<NR3> is the gain, in volts per division. The range is 5 V/div to 
2 mV/div when using a 1X probe. 


Examples 
CH1:SCALE 100E-3 
sets the channel 1 gain to 100 mV/div. 


CH2: SCALE? 
might return 1.0E0, indicating that the current V/div setting of 
channel 2 is 1 V/div. 


Related Commands 
CH1:VOLts 
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CH<x>:VOLts 


Sets or queries the vertical gain of the specified channel. This 
command is identical to the CH<x>:SCAle command and is included 
for compatibility purposes. Only CH<x>:SCAle is returned in 
response to a CH<x>? query. 


Group 
Vertical 


Syntax 
CH<x>:VOLts <NR3> 


CH<x>:VOLts? 


Arguments 
<NR3> is the gain, in volts per division. The range is 5 V/div to 
2 mV/div when using a 1X probe. 


Examples 


CH1:VOLTS 100E-3 
sets the channel 1 gain to 100 mV/div. 


CH2:VOLTS? 
might return 1.0E0, indicating that the current V/div setting of 
channel 2 is 1 V/div. 


Related Commands 
CH1:SCAle 
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*CLS (No Query Form) 


Clears the oscilloscope status data structures. 


Group 
Status and Error 


Syntax 
ECLS 


The *CLS command clears the following: 

® the Event Queue 

® the Standard Event Status Register (SESR) 

m the Status Byte Register (except the MAV bit; see below) 


If the *CLS command immediately follows a <EOI>, the Output 
Queue and MAV bit (Status Byte Register bit 4) are also cleared. 
MAV indicates information is in the output queue. The device clear 
(DCL) GPIB control message will clear the output queue and also 
MAV. 


*CLS does not clear the output queue or MAV. *CLS can suppress a 
service request that is to be generated by an *OPC command. This 
will happen if a hardcopy output or single sequence acquisition 
operation is still being processed when the *CLS command is 
executed. 


A complete discussion of these registers and bits, and of event 
handling in general, begins on page 3-1. 


Arguments 
None 


Examples 
None 


Related Commands 
DESE, *ESE, *ESR?, EVENT?, EVMsg?, *SRE, *STB? 
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CURSor? (Query Only) 


Returns all current oscilloscope cursor settings. 


Group 
Cursor 


Syntax 
CURSor? 


Returns 
Oscilloscope cursor parameters 


Examples 

CURSOR? 

might return CURSOR: FUNCTION VBARS;SELECT: SOURCE CH1; 

: CURSOR: VBARS: UNITS SECONDS; POSITION1 0.0E0;POSITION2 
4.50E-3;:CURSOR:HBARS: UNITS VOLTS; POSITION1 0.0E0;POSI- 
TION2 500.0E-3 as the current cursor settings. 


Related Commands 
None 


CURSor:FUNCtion 
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Selects and displays the oscilloscope cursor type. Cursors are 
attached to the waveform selected by CURSor:SELect:SOUrce. This 
command is equivalent to setting Type in the Cursor menu. 


NOTE. Setting the display format to XY turns cursors off. Sending the 


CURSor: FUNCtion command when the display format is XY causes 
the oscilloscope to generate event 221 (settings conflict) and leaves 
the display in XY format. 


Group 
Cursor 
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Syntax 
CURSor:FUNCtion { HBArs | OFF | VBArs } 


CURSor: FUNCtion? 


Arguments 


HBArs specifies horizontal bar cursors that measure the vertical units 
in volts, divisions, or decibels (decibels are TDS2MM Only). 


OFF removes the cursors from the display. 
VBArs specifies vertical bar cursors that measure time or frequency. 


Examples 


CURSOR: FUNCtion VBARS 
selects vertical bar type cursors. 


Related Commands 
CURSor:SELect 


CURSor:HBArs? (Query Only) 


Returns the current settings for the oscilloscope horizontal bar 
cursors. 


Group 
Cursor 


Syntax 
CURSor: HBArs? 


Returns 
Current horizontal bar cursor settings. 


Examples 

CURSOR: HBARS? 

might return CURSOR: HBARS: UNITS VOLTS;POSITION1 0.0E0; 
POSITION2 0.0E0. 
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CURSor:HBArs:DELTa? (Query Only) 


Returns the difference (in vertical units) between the two horizontal 
bar cursors in the oscilloscope display. 


NOTE. If the trigger view is active, this query returns 9.9E37 and 
generates event 221 (settings conflict). 


Group 
Cursor 


Syntax 
CURSor:HBArs:DELTa? 


Returns 
<NR3> 


Examples 


CURSOR: HBARS : DELTA? 
might return 5.08E+0 for the difference between the two cursors. 
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CURSor:HBArs:POSITION<x> 


Positions a horizontal bar cursor. 


NOTE. If the trigger view is active, the query form returns 9.9E37 
and generates event 221 (settings conflict). 


Group 
Cursor 


Syntax 
CURSor:HBArs:POSITION<x> <NR3> 


CURSor:HBArs: POSITION<x>? 


Arguments 
<x> specifies which cursor position, and has the value of 1 or 2. 


<NR3> specifies the horizontal bar cursor position, relative to ground 
(in volts when the units are volts), relative to the center of the screen 
(in divs when units are divisions), or relative to 1 V RMS (in 
decibels when the source is an FFT math waveform), for the 
waveform specified by the CURSor: SELect : SOUrce command. 

The cursor position is limited to the graticule whenever an attempt is 
made to move it outside the graticule. 


NOTE. The source always determines the measurement units. 


Examples 


CURSOR: HBARS:POSITION1 25.0E-3 
positions one of the horizontal cursors at 25.0 mV (assuming the 
vertical units are volts). 


CURSOR: HBARS: POSITION2? 
might return -64.0E-3, indicating that the position 2 horizontal bar 
cursor is at -64.0 mV (assuming the vertical units are volts). 
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CURSor:HBArs:UNIts? (Query Only) 


Returns the vertical scale units for the selected cursor source 
waveform. 


Group 
Cursor 


Syntax 
CURSor: HBArs:UNIts? 


Returns 
VOLts indicates volts from ground as the unit of measure. 


DIVs indicates divisions as the unit of measure, with center of screen 
as 0 divisions and bottom of screen as -4 divisions. 


DECIBELS indicates decibels as the unit of measure, relative to a 1 V 
RMS sine wave. 


UNKNOWN indicates the trigger view is active. This also generates 
event message 221, Settings conflict”. 


Examples 
CURSOR: HBARS: UNIts? 
might return CURSOR: HBARS: UNITS VOLTS. 


CURSor:SELect:SOUrce 
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Sets or queries the waveform that is the source of the vertical and 
horizontal scale factors used in determining cursor values. This 
command is equivalent to setting Source in the Cursor menu. 


Group 
Cursor 


Syntax 
CURSor:SELect:SOUrce <wfm> 


CURSor:SELect:SOUrce? 
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Arguments 


<wfm> specifies the waveform data source on which cursor 
measurements will be taken. 


Examples 


CURSOR: SELect:SOUrce CH1 
selects channel 1. 


CURSOR: SELect:SOUrce? 
might return MATH. 


CURSor:VBArs? (Query Only) 


Returns the current vertical bar cursor horizontal position and units 
settings. 


Group 
Cursor 


Syntax 
CURSor: VBArs? 


Examples 

CURSOR: VBARS? 

might return CURSOR: VBARS: UNITS SECONDS; 
POSITIONI 1.00E-6;POSITION2 9.00E-6 
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CURSor:VBArs:DELTa? (Query Only) 


Returns the time or frequency between the two vertical bar cursors. 
The units (seconds or Hertz) are specified by the CURSor:VBArs: 
UNIts command. If the cursor source is an FFT math waveform, 
CURSor: VBArs:DELTa is always in Hertz, regardless of the value 
set by CURSor: VBArs:UNIts. 


NOTE. If the trigger view is active, this query returns 9.9E37 and 
generates event 221 (settings conflict). 


Group 
Cursor 


Syntax 
CURSor: VBArs:DELTa? 


Returns 
<NR3> 


Examples 

CURSOR: VBARS:DELTa? 

might return 1.064E+00, indicating that the time between the vertical 
bar cursors is 1.064 seconds. 


Related Commands 
CURSor: VBArs:UNIts 
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CURSor:VBArs:POSITION<x> 


Positions a vertical bar cursor. The unit is specified by the 
CURSor: VBArs:UNIts command, and can be in units of seconds or 
frequency (Hertz). If the cursor source is an FFT math waveform, 
CURSor: VBArs:POSITION is always in Hertz, regardless of the 
value set by CURSor:VBArs:UNIts. 


NOTE. If the trigger view is active, the query form returns 9.9E37 
and generates event 221 (settings conflict). 


Group 
Cursor 


Syntax 
CURSor: VBArs : POSITION<x> <NR3> 


CURSor: VBArs: POSITION<x>? 


Arguments 
<x> specifies which cursor to position. Correct values are 1 and 2. 


<NR3> specifies the cursor position in the units specified by the 
CURSor: VBArs:UNIts command. The position is relative to the 
trigger except when the cursor source is a math FFT waveform. The 
cursor position is limited to the graticule whenever an attempt is 
made to move it outside the graticule. 


Examples 
CURSOR: VBARS:POSITION2 9.00E-6 
positions position 2 vertical bar cursor at 9 us. 


CURSOR: VBARS: POSITION1? 
might return 1.00E-6, indicating the position 1 vertical bar cursor is 
at 1 us. 


Related Commands 
CURSor: VBArs:UNIts 
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CURSor:VBArs:UNIts 


Sets or queries the units for the vertical bar cursors. 


Group 
Cursor 


Syntax 
CURSor:VBArs:UNIts { SECOnds | HERtz } 


CURSor:VBArs:UNIts? 


Arguments 
<SECOnds> specifies units of time. 
<HERtz> specifies units of frequency. 


Examples 


CURSOR: VBARS: UNITS SECONDS 
sets the units for the vertical bar cursors to seconds. 


CURSOR: VBARS: UNITS? 
returns HERTZ when the vertical bar cursor units are Hertz. 


Related Commands 
CURSor: VBArs:DELTa?, CURSor: VBArs:POSITION<x> 
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CURVe 


Transfers oscilloscope waveform data to and from the oscilloscope in 
binary or ASCII format. Each waveform that is transferred has an 
associated waveform preamble that contains information such as data 
format and scale. Refer to the WFMPre command starting on page 
2-158 for information about the waveform preamble. The data 
format is specified by the DATa:ENCdg and DATa:WIDTH 
commands. 


The CURVe? query sends data from the oscilloscope to an external 
device. The data source is specified by the DATa:SOUrce command. 
The first and last data points that are transferred are specified by the 
DATa:STARt and DATa:STOP commands. 


The CURVe command sends waveform data from an external device 
to the oscilloscope. The data is stored in the stored waveform 
location specified by DATa:DESTination, starting with the data point 
specified by DATa:STARt. Only one waveform can be transferred at 
atime. The waveform will only be displayed if the reference 
waveform is displayed. 


A description of the waveform transfer process starts on page 2-26. 


Group 
Waveform 


Syntax 
CURVe { <Block> | <asc curve> } 


CURVe? 


Arguments 

<Block> is the waveform data in binary format. The waveform is 
formatted as: #<x><yyy><data> where <x> is the number of 
characters in <yyy>. For example, if <yyy> = 500, then <x> = 3. 
<yyy> is the number of bytes to transfer. 


If width is 1, then all bytes on the bus are single data points. If width 
is 2, then all bytes on the bus are 2-byte pairs. Use the DATa:WIDth 
command to set the width. <data> is the curve data. 
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<asc Curve> is the waveform data in ASCII format. The format for 
ASCH data is <NR1>[,<NR1>...] where each <NR1> represents a 
data point. 


Examples 

CURVE? 

might return the ASCII data 

sCURVE 13,6,3,2,-1,-9,-14,-19,-29,-35,-67,-/1, oem 
=90,.731552757790512;29539545,43541547541 30, seem 


Related Commands 
DATa, WEMPre 


DATa 


Sets or queries the format and location of the waveform data that is 
transferred with the CURVe command. Since DATa:DESTination and 
DATa:TARget are equivalent, only DATa:DESTination is returned by 
the DATa? query. 


Group 
Waveform 


Syntax 
DATa { INIT } 


DATa? 
Arguments 


INIT initializes the waveform data parameters to their factory 
defaults. 
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Examples 
DATA INIT 
initializes the waveform data parameters to their factory defaults: 


DESTINATION = REFA (=TARGET) 
ENCDG = RIBINARY 


SOURCE = CH1 
START = 1 
STOP = 2500 
WIDTH = 1 
DATA? 


might return the string :DATA:ENCDG RPBINARY; DESTINATION 
REFA; SOURCE REFB;START 1;STOP 500;WIDTH 2 


Related Commands 
CURVE, WAVFrm 


DATa:DESTINATION 


Sets or queries the reference memory location for storing oscillo- 
scope waveform data that is transferred into the oscilloscope by the 
CURVe command. This command is identical to the DATa:TARget 
command. 


Group 
Waveform 


Syntax 
DATa:DESTINATION REF<x> 


DATa: DESTINATION? 
Arguments 


REF<x> stores waveform data into one of two locations. Valid 
locations are A or B. 
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Examples 
DATA: DESTINATION REFA 
stores incoming waveform data into reference memory REFA. 


DATA: DESTINATION? 
might return REFB as the waveform location that is currently 
selected. 


Related Commands 
CURVe?, DATa:TAR get 


DATa:ENCdg 


Sets or queries the format of the waveform data. This command is 
equivalent to setting WFMPre:ENCdg, WFMPre:BN_Fmt, and 
WFMPre:BYT_Or as shown in Table 2—21. Setting the DATa:ENCdg 
value causes the corresponding WFMPre values to be updated and 
vice versa. 


Group 
Waveform 


Syntax 
DATa:ENCdg { ASCIi | RIBinary | RPBinary | SRIbinary | 
SRPbinary } 


DATa:ENCdg? 


Arguments 

ASCIi specifies the ASCII representation of signed integer 
(RIBinary) data. If this is the value at power-on, the WFMPre values 
for BN_Fmt, BYT_Or, and ENCdg are set as RP, MSB, and ASC 
respectively. 
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RIBinary specifies signed integer data-point representation with the 
most significant byte transferred first. This format results in the 
fastest data transfer rate when DATa:WIDth is set to 2. 


The range is —128 to 127 when DATa: WIDth is 1. Zero is center 
screen. The range is -32768 to 32767 when DATa: WIDth is 2. The 
upper limit is one division above the top of the screen and the lower 
limit is one division below the bottom of the screen. 


RPBinary specifies positive integer data-point representation with 
the most significant byte transferred first. 


The range is 0 to 255 when DATa:WIDth is 1. Center screen is 127. 
The range is 0 to 65,535 when DATa:WIDth is 2. The upper limit is 
one division above the top of the screen and the lower limit is one 
division below the bottom of the screen. 


SRI binary is the same as RIBinary except that the byte order is 
swapped, meaning that the least significant byte is transferred first. 
This format is useful when transferring data to IBM compatible PCs. 


SRPbinary is the same as RPBinary except that the byte order is 
swapped, meaning that the least significant byte is transferred first. 
This format is useful when transferring data to IBM compatible PCs. 


Table 2-21: DATa and WFMPre Parameter Settings 


WFMPre Settings 
DATa:ENCdg Setting :BYT_Or 
ASCLi ASC N/A N/A 
RIBinary BIN MSB 


RPBinary BIN 
SRIbinary BIN 
SRPbinary BIN 


MSB 
LSB 
LSB 


Cj — 
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Examples 

DATA: ENCDG RPBINARY 

sets the data encoding format to be positive integer where the most 
significant byte is transferred first. 


DATA: ENCDG? 
might return SRPBINARY for the format of the waveform data. 


Related Commands 
WFMPre:ENCdg, WFMPre:BN.FMT, WFMPre:BYT_Or 


DATa:SOUrce 


Sets or queries which waveform will be transferred from the 
instrument by the CURVe?, WFMPre?, or WAVFrm? queries. You 
can transfer only one waveform at a time. 


Group 
Waveform 


Syntax 
DATa:SOUrce <wfm> 


DATa:SOUrce? 


Arguments 
<wfm> is the location of the waveform data that will be transferred 


from the oscilloscope to the external device. Correct values are CH1, 
CH2, MATH, REFA, and REFB. 


Examples 
DATA: SOURCE REFB 


specifies that reference waveform REFB will be transferred in the 
next CURVE? query. 


DATA: SOURCE? 
might return REFA, indicating the source for the waveform data that 
is transferred using CURVE?. 


Related Commands 
CURve?, WEMPre?, WAVFrm? 
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DATa:STARt 


Sets or queries the starting data point for waveform data transfers. 
This command lets you transfer partial waveforms to and from the 
oscilloscope. 


Group 
Waveform 


Syntax 
DATa:STARt <NR1> 


DATa:STARt? 


Arguments 


<NR1> is an integer value that ranges from 1 to 2500, and specifies 
the first data point that will be transferred. Data is transferred from 
<NR1> to DATa:STOP or 2500, whichever is less. When DATa:STOP 
is less than DATa:STARt, the values are swapped internally for 
CURVe?. 


Examples 


DATA:START 10 
specifies that the waveform transfer will begin with data point 10. 


DATA:START? 
might return 214 as the first waveform data point that will be 
transferred. 


Related Commands 
CURVe?, DATa:STOP 
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DATa:STOP 


Sets or queries the last data point in the waveform that will be 
transferred when executing the CURVe? command. This lets you 
transfer partial waveforms from the oscilloscope. 


When using the CURVe command, the oscilloscope stops reading 
data when there is no more data to read or when the 2500 data point 
limit is reached. 


Group 


Waveform 


Syntax 
DATa:STOP <NR1> 


DATa:STOP? 


Arguments 


<NR1> is an integer value that ranges from 1 to 2500, and specifies 
the last data point that will be transferred. When DATa:STOP is less 
than DATa:STARt, the values are swapped internally for CURVe?. 


If you always want to transfer complete waveforms, set DATa:STARt 
to 1 and DATa:STOP to 2500. 


Examples 
DATA:STOP 150 
specifies that the waveform transfer will stop at data point 150. 


DATA:STOP? 
might return 285 as the last data point that will be transferred. 


Related Commands 
CURVe?, DATa START 
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DATa:TARget 


Sets or queries the location for storing waveform data transferred 
from an external device to the oscilloscope when executing the 
CURVe command. This command is equivalent to the DATa:DES- 
TINATION command and is included here for compatibility with 
older Tektronix instruments. 


Group 
Waveform 


Syntax 
DATa:TARget REF<x> 


DATa: TARget? 


Arguments 


REF<x> specifies the waveform storage location. Accepted values are 
A and B. 


Examples 
DATA: TARget REFA 
stores incoming waveform data into the Ref A storage area 


DATA: TARget? 
might return REFB as the waveform location that is currently 
selected. 


Arguments 
REF<X> 


Examples 
None 


Related Commands 
CURVe, DATa:DESTINATION 
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DATa:WIDth 


*DDT 
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Sets the number of bytes per waveform data point to be transferred 
when executing the CURVe command. 


Group 
Waveform 


Syntax 
DATa:WIDth <NR1> 


DATa:WIDth? 


Arguments 


<NR1> = I sets the number of bytes per waveform data point to 1 byte 
(8 bits). 


<NR1> = 2 sets the number of bytes per waveform data point to 2 
bytes (16 bits). This argument is included only for compatibility. If 
DATa:WIDth is set to 2, the least significant byte is always zero. 


Examples 
DATA:WIDth 1 
sets the data width to 1 byte per data point for CURVe data. 


Related Commands 
CURVe, WFMPre:BIT_Nr, WFMPre:BYT_Nr 


Lets you specify a command or a list of commands to execute when 
the instrument receives a *TRG command or the GET GPIB 
interface message. This is a special alias that *TRG uses. 


Group 
Miscellaneous 
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Syntax 
*DDT { <Block> | <QString> } 


*DDT? 


Arguments 


<Block> or <QString> is a complete sequence of program messages. 
The messages must contain only valid commands that must be 
separated by semicolons and must follow all rules for concatenating 
commands (see page 2-6). The sequence must be <80 characters. 
<Block> format is always returned as a query response. 


Examples 

*DDT #217ACQUIRE:STATE RUN<EOI> 

specifies that the acquisition system will be started each time a 
*TRG command is sent. 


Related Commands 
*TRG 


DESE 


Sets and queries the bits in the Device Event Status Enable Register 
(DESER). The DESER is the mask that determines whether or not 
events are reported to the Standard Event Status Register (SESR), 
and entered into the Event Queue. For a more detailed discussion of 
the use of these registers, see page 3-1. 


Group 
Status and Error 


Syntax 
DESE <NR1> 


DESE? 
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. Arguments 


<NR1> is an integer value in the range from 0 to 255. The binary bits 
of DESER are set according to this value. For example, DESE 209 
sets the DESER to the binary value 11010001 (that is, the most 
significant bit in the register is set to 1, the next most significant bit 
to 1, the next bit to 0, and so on). 


The power-on default for DESER is all bits set to 1 if *PSC is 1. If 
*PSC is 0, the DESER maintains its value through a power cycle. 


NOTE. Setting DESER and ESER to the same value allows only those 


codes to be entered into the Event Queue and summarized on the 
ESB bit (bit 5) of the Status Byte Register. Use the *ESE command to 
set ESER. A discussion of event handling begins on page 3-1. 


Examples 

DESE 209 

sets the DESER to binary 11010001, which enables the PON, URQ, 
EXE, and OPC bits. 


DESE? 
might return the string :DESE 186, showing that DESER contains the 
binary value 10111010. 


Related Commands 
*CLS, *ESE, *ESR?, EVENT?, EVMsg?, *SRE, *STB? 


DIAg:RESUIt:FLAg? (Query Only) 
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Returns the pass/fail status from the last diagnostic test sequence 
execution. Use the DIAg:RESUIt:LOG? query to determine which 
test(s) has failed. 


Group 
Calibration and Diagnostic 


Syntax 
DIAg:RESUIt: FLAg? 
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Returns 
PASS means that the oscilloscope passes all diagnostic tests. 


FAI1 means that the oscilloscope has failed at least one of the 
diagnostic tests. 


Examples 
DIAG:RESULT: FLAG? 
returns either PASS or FAI1. 


Related Commands 
DIAg:RESUIt:LOG? 


DIAg:RESUIt:LOG? (Query Only) 


Returns the internal results log from the last diagnostic test sequence 
execution. The list contains all modules and module interfaces that 
were tested along with the pass/fail status of each. 


Group 
Calibration and Diagnostic 


Syntax 
DIAg:RESUIt:LOG? 


Returns 
<QString> in the following format: 


<Status>,<Module name>[,<Status>,<Module name>... ] 
Examples 
DIAG:RESULT: LOG? 


might return "pass--CPU, pass--Acquisition, pass--Exten- 
sion" for power-up diagnostics. 


Related Commands 
DIAg:RESUIt:FLAg? 
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DiSplay? (Query Only) 


Returns the current display settings. 


Group 
Display 


Syntax 
DISplay? 


Returns 
The current display settings 


Examples 

DISPLAY? 

might return :DISPLAY: FORMAT YT;STYLE VECTORS; 
PERSISTENCE OFF;CONTRAST 50 


Related Commands 
None 


DiSplay:CONTRast 
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Sets or queries the contrast of the LCD display. This command is 
equivalent to setting Contrast in the Display menu. 


Group 
Display 


Syntax 
DISplay:CONTRast <NR1> 


DISplay:CONTRast? 
Arguments 


<NR1> is an integer in the range from 1 through 100. The larger the 
value, the greater the screen contrast. 
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Examples 
DISplay:CONTRast 63 
sets the display contrast to 63. 


Related Commands 
None 


DiSplay:FORMat 


Sets or queries the oscilloscope display format. This command is 
equivalent to setting Format in the Display menu. 


Group 
Display 


Syntax 
DISplay:FORMat { XY | YT } 


DISplay:FORMat? 


Arguments 

XY displays the voltage of channel 1 against the voltage of channel 2. 
Displaying one source causes its corresponding source to be 
displayed. 


NOTE. Setting the display format to XY turns cursors off. Sending the 
CURSor: FUNCtion command when the display format is XY causes 
the oscilloscope to generate event 221 (settings conflict) and leaves 
the display in XY format. 


YT sets the display to vertical values versus time format and is the 
normal mode. 
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Examples 
DISPLAY: FORMAT YT 
selects a voltage versus time format for the display. 


DISPLAY: FORMAT? 
might return XY for the display format. 


Related Commands 
None 


DiSplay: PERSistence 


Sets the length of time that data points are displayed. 


Group 
Display 


Syntax 
DISplay:PERSistence { 1 | 2 | 5 | INF | OFF } 
DISplay:PERSistence? 


Arguments 


1 | 2 | 5 specifies the length, in seconds, that the waveform points 
are displayed on the screen. 


INF specifies infinite persistence. 


OFF specifies that persistence is turned off. 


Returns 
0 means that the persistence is turned off. 


2 or 5 means that the persistence is set to two or five seconds. 


99 means that the persistence is set to infinite. 
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Examples 


DISPLAY:PERSISTENCE 5 
specifies that the waveform points are displayed on the screen for 
five seconds before they fade. 


Related Commands 
DISplay:STYle 


DiSplay:STYle 


Selects how to display the waveform data. This command is 
equivalent to setting Type in the Display menu. 


Group 
Display 


Syntax 

DISplay:STYle { DOTs | VECtors } 
DISplay:STYle? 

Arguments 

DOTs displays individual data points. 


VECtors connects adjacent data points. 


Examples 
DISPLAY:STYLE VEC 
sets the display to connect adjacent data points. 


DISPLAY: STYLE? 
might return DOTS indicating that the display shows individual 
waveform data points. 


Related Commands 
DISplay:PERSistence 
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ERRLOG:FIRST? (Query Only) 


Returns the first entry in the error log, or an empty string if the error 
log is empty. Use this command along with ERRLOG:NEXT? to 
retrieve error log messages. 


Group 
Calibration and Diagnostic 


Syntax 
ERRLOG: FIRST? 


Returns 


Refer to the TDS 210 & TDS 220 Service Manual for information 
about error log message format. 


Related Commands 
ERRLOG:NEXT? 


ERRLOG:NEXT? (Query Only) 


Returns the next entry in the error log, or an empty string if the error 
log is empty or you have reached the end of the log. To start at the 
top of the error log, run the ERRLOG:FIRST? query to return the 
first error log message. Then use the ERRLOG:NEXT? query to step 
through the error log. 


Group 
Calibration and Diagnostic 


Syntax 
ERRLOG: NEXT? 
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Returns 


Refer to the TDS 210 & TDS 220 Service Manual for information 
about error log message format. 


Related Commands 
ERRLOG:FIRST? 


*ESE 


Sets and queries the bits in the Event Status Enable Register (ESER). 
The ESER prevents events from being reported to the Status Byte 
Register (STB). For a more detailed discussion of the use of these 
registers, see page 3-1. 


Group 
Status and Error 


Syntax 
*ESE <NR1> 


SESE? 


Arguments 
<NR1> is a value in the range from 0 through 255. The binary bits of 
the ESER are set according to this value. 


The power-on default for ESER is 0 if *PSC is 1. If *PSC is 0, the 
ESER maintains its value through a power cycle. 


NOTE. Setting the DESER and the ESER to the same value allows 
only those codes to be entered into the Event Queue and summarized 
on the ESB bit (bit 5) of the Status Byte Register. Use the DESE 
command to set the DESER. A discussion of event handling begins on 
page 3-1. 
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Examples 

XESE209 

sets the ESER to binary 11010001, which enables the PON, URQ, 
EXE, and OPC bits. 


AESES 
might return the string *ESE 186, showing that the ESER contains 
the binary value 10111010. 


Related Commands 
*CLS, DESE, *ESR?, EVENT?, EVMsg? *SRE, *STB? 


*ESR? (Query Only) 


Returns the contents of the Standard Event Status Register (SESR). 
*ESR? also clears the SESR (since reading the SESR clears it). For a 
more detailed discussion of the use of these registers see page 3-1. 


Group 
Status and Error 


Syntax 
*ESR? 


Returns 
Contents of the Standard Event Status Register. 


Examples 

*ESR? 

might return the value 213, showing that the SESR contains binary 
11010101. 


Related Commands 
ALLEv?, *CLS, DESE, *ESE, EVENT?, EVMsg?, *SRE, *STB? 
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EVENT? (Query Only) 


Returns from the Event Queue an event code that provides 
information about the results of the last *ESR? read. EVENT? also 
removes the returned value from the Event Queue. A discussion of 
event handling begins on page 3-1. 


Group 
Status and Error 


Syntax 
EVENT? 


Returns 
Event code <NR1> 


Examples 

EVENT? 

might return the response :EVENT 110, showing that there was an 
error in a command header. 


Related Commands 
ALLEv?, *CLS, DESE, *ESE, *ESR?, EVMsg?, *SRE, *STB? 


EVMsg? (Query Only) 


Removes from the Event Queue a single event code associated with 
the results of the last “ESR? read, and returns the event code along 
with an explanatory message. A more detailed discussion of event 
handling begins on page 3-1. 


Group 
Status and Error 


Syntax 
EVMsg? 
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Returns 
The event code and message in the following format: 


<Event Code><Comma><QString>[<Event Code><Comma> 
<QString>...] 


<QString>::= <Message>; [<Command>] 


where <Command> is the command that caused the error and may be 
returned when a command error is detected by the oscilloscope. As 
much of the command as possible is returned without exceeding the 
60 character limit of the <Message> and <Command> strings 
combined. The command string is right-justified. 


Examples 
EVMSG? 
might return the message :EVMSG 110,"Command header error". 


Related Commands 
ALLEv?, *CLS, DESE, *ESE, *ESR?, EVENT?, *SRE, *STB? 


EVQty? (Query Only) 


Returns the number of event codes that are in the Event Queue. This 
is useful when using ALLEv? since it lets you know exactly how 
many events will be returned. 


Group 
Status and Error 


Syntax 
EVQty? 


Returns 
<NR1> 


2-86 TDS 200-Series Programmer Manual 


Command Descriptions 


Examples 
EVQTY? 
might return 3 as the number of event codes in the Event Queue. 


Related Commands 
ALLEv?, EVENT?, EVMsg? 


FACtory (No Query Form) 


Resets the oscilloscope to its factory default settings. Refer to 
Appendix B for a list of the factory default settings. 


Group 
Miscellaneous 


Syntax 
FACtory 


Setting the oscilloscope to factory default has the following impact 
on the programming interface: 


m™ Clears the Event Status Enable Register 

@ Clears the Service Request Enable Register 

m Sets the Device Event Status Enable Register to 255 

m Sets the Power On Status Clear Flag to TRUE 

™ Enables all Command Headers (HEADer ON) 

® Sets the macro defined by *DDT to a “zero-length field” 

m™ Clears the pending operation flag and associated operations 


= Performs the equivalent of DATA INIT 
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The FACtory command does not alter the following: 


The state of the RS-232 or GPIB interface 

The selected GPIB address 

Calibration data that affects device specifications 
Stored settings 

Stored waveforms or data 

Hard copy parameters 

Display messages language selection 

Front panel LOCK state 


Verbose state 


Arguments 
None 


Examples 
None 


Related Commands 
*PSC, *RCL, RECAI:SETUp, *RST, *SAV, SAVe:SETUp 
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HARDCopy 


Sends a copy of the screen display followed by an EOI to the port 
specified by HARDCopy:PORT. The format and layout of the output 
is specified with the HARDCopy:FORMat and HARDCopy:LAYout 
commands. This command is equivalent to pressing the front-panel 
HARDCOPY button. 


HARDCopy? returns format, layout, and port information. 


NOTE. This command is not IEEE Std 488.2-1987 compatible. 


Group 
Hard copy 


Syntax 
HARDCopy { ABOrt | STARt } 


HARDCopy? 


Arguments 
ABOrt terminates the hard copy output in process. 


NOTE. DCL does not clear the output queue once a hard copy is in 
process. The only way to abort the hard copy process is to send the 
HARDCopy ABOrt command. The output queue can then be cleared 
by sending a DCL message. 


STARt initiates a screen copy that is sent to the port specified by the 
HARDCOPY:PORT command. 


NOTE. Use the *WAI command between HARDCopy STARt 
commands to ensure that the first hard copy is complete before 
starting another. 
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Examples 
HARDCOPY ABORT 
stops any hard copy output that is in process. 


Related Commands 
*WAIT 


HARDCopy:FORMat 
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Sets the hard copy output data format. This command is the same as 
setting Format in the UTILITY > Options p>» Hard Copy Setup 
menu. 


Group 
Hard copy 


Syntax 


HARDCopy:FORMat { BMP | DESKJet | EPSOn | LASERJet | 
THInkjet | PCX | EPSIMAGE | INTERLEAF | 
DPU411 | DPU412 } 


HARDCopy: FORMat? 


Arguments 


BMP sets the hard copy output data to Microsoft Windows Bitmap 
format. 


DESKjet sets the hard copy output data to high-resolution printer 
format. 


EPSOn sets the hard copy output data to 9-pin or 24-pin dot matrix 
printer format. 


LASERJet sets the hard copy output data to laser printer format. 
THInkjet sets the hard copy output data to inkjet printer format. 
PCX sets the hard copy output data to DOS Paintbrush format. 
EPSIMAGE sets the hard copy output data to Postscript format. 
INTERLEAF sets the hard copy output data to Interleaf file format. 
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DPU411 DPU412 sets the hard copy output data to Seiko DPU 411 or 
DPU 412 printer format (available only when using TDS 200-Series 
units with firmware version FV:v1.09 and greater, or TDS2CM 
modules with firmware version CMV:v1.04 and greater, or TDS2MM 
modules with firmware version MMV:v1.00 and greater). 


Examples 


HARDCOPY: FORMAT LASERJet 
sets the hard copy output format to LaserJet. 


HARDCOPY : FORMAT ? 
might return EPSON as the hard copy output format. 


Related Commands 
None 


HARDCopy:LAYout 


Selects the printing orientation. This command is equivalent to 
setting Layout in the UTILITY > Options > Hard Copy Setup 
menu. 


Group 
Hard copy 


Syntax 
HARDCopy:LAYout { LANDscape | PORTRait } 


HARDCopy:LAYout? 


Arguments 


LANDscape specifies that the bottom of the hard copy is along the 
long side of the page. 


PORTRait specifies that the bottom of the hard copy is along the 
short side of the page. This is the standard format. 
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Examples 

HARDCOPY : LAYOUT? 

might return PORTRAIT as the page layout format of the hard copy 
output. 


Related Commands 
None 


HARDCopy:PORT 


Selects where to send the hard copy data when the oscilloscope 
receives the next HARDCOPY START command. This command is 
equivalent to setting Port in the UTILITY }> Options p>» Hard Copy 
Setup menu. 


Group 
Hard copy 


Syntax 
HARDCopy:PORT { CENtronics | RS232 | GPIB } 
HARDCopy : PORT? 


Arguments 


CENtronics specifies that the hard copy data is sent out the 
Centronics port. 


RS232 specifies that the hard copy data is sent out the RS232 port. 
GPIB specifies that the hard copy data is sent out the GPIB port. 


Examples 
HARDCOPY : PORT? 
might return RS232 as the selected hard copy output port. 


Related Commands 
HARDCopy 
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HDR 


This command is identical to the HEADer query and is included for 
compatibility with older Tektronix instruments. 


Group 
Miscellaneous 


Syntax 
HDR { <NR1> | OFF | ON } 


HDR? 
Arguments 


<NR1> | OFF | ON 
Refer to descriptions in the HEADer command. 


Examples 
None 


Related Commands 
HEADer 


HEADer 


Sets and queries the Response Header Enable State that causes the 
oscilloscope to either include or omit headers on query responses. 
This command does not affect IEEE Std 488.2-1987 Common 
Commands (those starting with an asterisk); they never return 
headers. 


Group 
Miscellaneous 


Syntax 
HEADer { <NR1> | OFF | ON } 


HEADer? 
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Arguments 


ON or <NR1> $ 0 sets the Response Header Enable State to true. This 
causes the oscilloscope to include headers on applicable query 
responses. You can then use the query response as a command. 


OFF or <NR1> = 0 sets the Response Header Enable State to false. 
This causes the oscilloscope to omit headers on query responses so 
that only the argument is returned. 


Examples 
HEADER OFF 
causes the oscilloscope to omit headers from query responses. 


HEADER? 
might return the value 1, showing that the Response Header Enable 
State is true. 


Related Commands 
VERBos 


HORizontal? (Query Only) 


Returns all settings for the horizontal commands. The commands 
HORizontal:MAIn:SCAle, HORizontal:MAIn:SECdiv, HORizon- 
tal:SCAle, and HORizontal:SECdiv are equivalent, so HORizon- 
tal:MAIn:SCAle is the value that is returned. 


The commands HORizontal:MAIn:POSition and HORizontal:POSi- 
tion are equivalent, so HORizontal:MAIn:POSition is the value that 
is returned. 


Group 
Horizontal 


Syntax 
HORizontal? 


Returns 
Returns all horizontal settings 
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Examples 

HORIZONTAL? 

might return the string : HORIZONTAL: VIEW MAIN;RECORDLENGTH 
2500;MAIN: POSITION 0.0E+0;SCALE 5.0E-4;HORIZON- 

TAL: DELAY: POSITION 0.0E+0;SCALE 2.5E-4 


Related Commands 
None 


HORizontal:DELay? (Query Only) 


Returns all settings for the window time base. The commands 
HORizontal: DELay:SECdiv and HORizontal:DELay:SCAle are 
equivalent, so only the values for HORizontal: DELay:SCAle are 
returned. 


Group 
Horizontal 


Syntax 
HORi zontal :DELay? 


Returns 
All settings for the window time base 


Examples 


HORIZONTAL: DELAY? 
might return : HORIZONTAL: DELAY: POSITION 0.0E+0; 
SCALE 5.0E-4. 


HORizontal:DELay:POSition 


Sets or queries the window time base horizontal position. This 
command is equivalent to adjusting the Horizontal Position when 
Window Zone or Window is selected from the Horizontal menu. 


Group 
Horizontal 
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Command Descriptions 


Syntax 
HORi zontal :DELay:POSition <NR3> 


HORi zontal :DELay:POSition? 


Arguments 

<NR3> is the position in seconds. This value is the difference between 
the trigger point and the center graticule. Positive values place the 
trigger before the center graticule. 


Examples 
HORIZONTAL: DELAY: POSition 2.0E-6 
sets the window position to 2 us before the center graticule. 


HORIZONTAL: DELAY : POSition? 
might return -1.0E-3, indicating that the window position is 1 ms 
after the center graticule. 


Related Commands 
HORizontal: DELay:SECdiv 


HORizontal:DELay:SCAle 


Sets the time per division for the oscilloscope window time base. 
This command is equivalent to setting SEC/DIV when Window Zone 
or Window is selected from the Horizontal menu. 


Group 
Horizontal 


Syntax 
HORi zontal :DELay:SCAle <NR3> 


HORi zontal :DELay:SCAle? 


Arguments 

<NR3> is the time per division. The range is 5 ns to 5 s in a 1-2.5-5 
sequence. If the window time base scale is set slower than the main 
time base scale, both the main and window time base scales are set to 
the window scale value. 
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Examples 
HORIZONTAL: DELAY:SCALE 2.0E-6 
sets the window scale to 2 us per division. 


HORIZONTAL: DELAY: SCALE 9.0E-6 

sets the window scale to 10 us per division. Since 9 us is not a 
correct value within the 1-2.5-5 sequence, it is automatically set to 
the closest correct value. 


HORIZONTAL: DELAY : SCALE? 
might return 1.0E-3, indicating that the window scale is 1 ms per 
division. 


Related Commands 
HORizontal: DELay:SECdiv 


HORizontal: DELay:SECdiv 


This command is identical to the HORizontal: DELay:SCAle 
command. It is provided to maintain program compatibility with 
some older models of Tektronix oscilloscopes. 


Group 
Horizontal 


Syntax 
HORi zontal :DELay:SECdiv <NR3> 


HORi zontal :DELay:SECdiv? 


Arguments 
Same as HORizontal: DELay:SCAle 


Examples 
Same as HORizontal: DELay:SCAle 


Related Commands 
HORizontal: DELay:SCAle 
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HORizontal:MAIn? (Query Only) 


Returns all settings for the oscilloscope main time base. The 
commands HORizontal:MAIn:SECdiv and HORizontal:MAIn:SCAle 
are identical so only HORizontal:MAIn:SCAle is returned. 


Group 


Horizontal 


Syntax 
HORi zontal :MAIn? 


Returns 
All settings for the main time base. 


Examples 
HORIZONTAL: MAIN? 
might return :HORIZONTAL:MAIN:POSITION 0.0E+0;SCALE 5.0E-4. 


Related Commands 
HORizontal:SCAle, HORizontal:SECdiv, HORizontal:MAIn:SECdiv 


HORizontal:MAIn:POSition 
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Sets or queries the main time base horizontal position. This 
command is equivalent to adjusting the Horizontal Position when 
Main is selected from the Horizontal menu. 


Group 
Horizontal 


Syntax 
HORi zontal :MAIn:POSition <NR3> 


HORi zontal :MAIn:POSition? 
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TDS1000B and TDS2000B 
Supplement 


Read This First 


USB Flash Drives 


USB flash drives that have never been used before need to be 
formatted on a PC prior to use with your oscilloscope. 


USBTMC Compliance 


When the oscilloscope was manufactured, it was not fully USBTMC 
compliant. For information on unsupported features, please read the 
TDS1000B and TDS2000B release notes on the www.tektronix.com 
Web site. 


Please check the www.tektronix.com Web site for a new version of 
firmware that includes the features needed to make the oscilloscope 
fully USBTMC compliant. 


The USB Device port supports the PC Communications software on 
the CD that came with the oscilloscope. 


TEK-USB-488 GPIB to USB Adapter Compatility 

When the oscilloscope was manufactured, it was not compatible with 
the TEK-USB-488 adapter. Please check the www.tektronix.com 
Web site for a new version of TEK-USB-488 adapter firmware and 
oscilloscope firmware that are compatible. 


UNION VAAN AOA Tektronix 
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Lecteurs flash USB 


Les lecteurs flash USB qui n’ont jamais été utilisés doivent étre 
formatés sur un ordinateur avant de les utiliser avec votre oscillo- 
scope. 


Compatibilite USBTMC 


Lors de la fabrication de |’oscilloscope, il n’était pas entiérement 
compatible USBTMC. Pour plus d’informations sur les fonctions non 
prises en charge, consultez les notes de mises a jour TDS1000B et 
TDS2000B sur le site Web www.tektronix.com. 


Visitez le site Web www.tektronix.com pour obtenir une nouvelle 
version du microprogramme comprenant les fonctions nécessaires 
pour rendre |’oscilloscope compatible USBTMC. 


Le port périphérique USB prend en charge le logiciel de communica- 
tion pour PC sur le CD fourni avec l’oscilloscope. 


Adaptateur GPIB/USB TEK- USB- 488 


Lors de la fabrication de |’oscilloscope, il n’était pas compatible 
avec |’adaptateur TEK-USB-488. Visitez le site Web www.tektro- 
nix.com pour obtenir une nouvelle version des microprogrammes de 
l’adaptateur TEK-USB-488 et de |’oscilloscope compatibles. 


www.tektronix.com 
Copyright © Tektronix, Inc. 
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Unita Flash USB 


Le unita Flash USB che non sono mai state usate devono essere 
formattate su un PC prima dell’utilizzo con |’oscilloscopio. 


Conformita USBTMC 


L’oscilloscopio con i parametri di fabbrica non é totalmente 
compatibile con USBTMC. Per informazioni sulle funzioni non 
supportate leggere le Release Note per TDS1000B TDS2000B sul 
sito www.tektronix.com. 


Visitare il sito www.tektronix.com per una nuova versione del 
firmware che include le funzioni necessarie a rendere |’oscilloscopio 
compatibile con USBTMC. 


La porta del dispositivo USB supporta il software di comunicazione 
per PC presente nel CD fornito unitamente all’ oscilloscopio. 


TEK-USB-488 Adattatore da GPIB a USB 


L’oscilloscopio con i parametri di fabbrica non € compatibile con 
V’adattatore TEK-USB-488. Visitare il sito www.tektronix.com per 
una nuova versione del firmware dell’adattatore TEK-USB-488 e per 
informazioni sui firmware dell’oscilloscopio compatibili. 
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Read This First Supplement 


USB-Flash-Laufwerke 


USB-Flash-Laufwerke, die noch nie vorher verwendet wurden, 
miissen auf einem PC formatiert werden, bevor Sie sie mit Ihrem 
Oszilloskop verwenden k6nnen. 


USBTMC Kompatibilitat 


Als das Oszillokop hergestellt wurde, war es noch nicht voll 
USBTMC kompatibel. Um Informationen zu den Funktionen zu 
erhalten, die nicht unterstiitzt werden, lesen Sie bitte die 
Herstellerhinweise zu TDS1000B und TDS2000B auf der Webseite 
www.tektronix.com. 


Bitte sehen sie auf der Webseite www.tektronix.com nach, ob eine 
neue Version der Firmware verfiigbar ist, die Funktionalitit enthalt, 
die das Oszilloskop véllig USBTMC kompatibel macht. 


Die USB-Gerateschnittstelle unterstiitzt die PC-Kommunikations- 
software auf der CD, die dem Oszilloskop beiliegt. 


Kompatibilitat zwischen TEK-USB-488 GPIB und USB-Adapter 


Als das Oszillokop hergestellt wurde, war es noch nicht voll 
kompatibel mit dem TEK-USB-488-Adapter. Bitte sehen sie auf der 
Webseite www.tektronix.com nach, ob eine neue Version der 
TEK-USB-488-Adapter Firmware verfiigbar ist, die kompatibel ist. 
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Read This First Supplement 


Unidades Flash USB 


Las unidades Flash USB que no se han usado nunca deben 
formatearse en un PC antes de usarse con el osciloscopio. 


Compatibilidad con USBTMC 


En el momento de su fabricacién, el osciloscopio no era totalmente 
compatible con USBTMC. Para obtener més informacién sobre las 
caracteristicas no compatibles, lea las notas de la version de los 
osciloscopios de la serie TDS1000B y TDS2000B en el sitio Web 
www.tektronix.com. 


Consulte el sitio Web www.tektronix.com para obtener una nueva 
version del firmware que incluya las funciones necesarias para que el 
osciloscopio sea totalmente compatible con USBTMC. 


El puerto de dispositivos USB es compatible con el software PC 
Communications incluido en el CD que acompaiia al osciloscopio. 


Capacidad del adaptador TEK-USB-488 GPIB para USB 


En el momento de su fabricacié6n, el osciloscopio no era compatible 
con el adaptador TEK-USB-488. Consulta el sitio Web 
www.tektronix.com para obtener una nueva version del firmware del 
adaptador TEK-USB-488 y del firmware del osciloscopio que sean 
compatibles : 
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Read This First Supplement 


USB Flash Drives 


USB flash drives que nunca foram usadas precisam ser formatadas 
em um PC antes de serem usadas com seu oscilosc6pio. 


Conformidade com USBTMC 


Quando 0 osciloscépio foi fabricado, ele n4o era totalmente 
compativel com USBTMC. Para obter informacées sobre os recursos 
nao suportados, leia as notas de langamento TDS1000B e TDS2000B 
no site www.tektronix.com. 


Confira 0 site www.tektronix.com para obter uma nova vers4o do 
firmware, que inclui os recursos necessérios para tornar o 
oscilosc6pio totalmente compativel com USBTMC. 


A porta do dispositivo USB suporta 0 software PC Communications 
que esta no CD quem veio com 0 osciloscépio. 


Capacidade do Adaptador TEK-USB-488 GPIB para USB 


Quando o oscilosc6épio foi fabricado, ele n4o era totalmente 
compativel com o adaptador TEK-USB-488. Confira 0 site 
www.tektronix.com para obter uma nova versio do firmware do 
adaptador TEK-USB-488 e do firmware do osciloscépio, que sao 
compativeis. 
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USB Wks 
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3anomuHatoune ycTpovcTBa USB 


Hosple 3amoMuHatole yctpolictsa USB nepex ucnomb30BaHHeM Ha 
oclM1orpade HeOOxoZHMO OTPopMaTHpoBaTh Ha MepcOHasIbHOM 
KOMIIbIOTepe. 


Cosmectumoctb c USBTMC 


Bo Bpems TpoH3BOACTBAa 9TOTO OCLMIIOrpada OH He ObI MOMHOCTBHIO 
COBMeCTHMbIM Cc USBTMC. Cpeqenna 0 HenoaqepxuBaeMBIx 
(PYHKIUMAX CM. B MaTepHatax 10 TDS1000B u TDS2000B ua Be6-y3ne 
www.tektronix.com. 


Ha BeO-y3e www.tektronix.com HMeeTca HOBad BepCcHsA 
MHKPpOMporpaMMHOro OOecreyeHHA, KOTOPad COZepxKUT PyHKIMH, 
HeOOXOJHMEIe JIA MOJIHOH COBMECTHMOCTH OcLMIIOrpada c 
USBTMC. 


Ilopt yctpoticts USB noyzyzepxuBaeT NporpaMMy 
PC Communications, Haxoqallyroca Ha KOMMaKT-MCKe, 
TIOCTaBJIACMOM BMECTE C OCIIMIIOrpamom. 


Bo3MOXHOCTb padoTbi c agantepom GPIB-USB TEK-USB-488 


Bo BpeMa IIpon3BOACTBa 9TOFO OCIMIOrpada OH He ObII COBMECTHM C 
ajantepom TEK-USB-488. Ha Be6-y3ne www.tektronix.com uMeeTca 
HOBad BEPCHA MHKpOMporpaMMHOro ObecreyeHHA amantepa 
TEK-USB-488 u copMecTuMoe c Hei MHKpomporpaMMHoe 
oOecne4eHHe ociMorpada. 
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TDS1000B and TDS2000B Read This First 


Please save these pages for future reference. Add this information to 
the TDS1000B and TDS2000B Series Digital Storage Oscilloscope 
User Manual. 


The following menus have changed: 


= The Display menu includes the Display Style option. The Display 
Style option moved from the UTILITY » Options menu. 


= The UTILITY p Options menu includes an option to configure 
the Rear USB Port 


To configure the USB port on the back of the oscilloscope, push the 
UTILITY p Options p» Rear USB Port option button, and select one 
of the following settings: 


= The Computer selection sets the oscilloscope to communicate 
with a computer. 


m The Printer selection sets the oscilloscope to communicate with a 
PictBridge compatible printer. 


= The Auto Detect selection (the default) lets the oscilloscope 
automatically configure the port for a computer or for a printer. 


NOTE. The GPIB adapter and some computer operating systems may 
not function as desired with the Auto Detect selection. If this is the 
case, change the setting to Computer. 


The oscilloscope stores the Rear USB Port setting until you change 
it, even if you push the DEFAULT SETUP button or you power off 
the oscilloscope. 
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A lire avant utilisation 


TDS1000B et TDS2000B - A lire avant 
utilisation 


Veuillez enregistrer ces pages pour référence ultérieure. Ajoutez ces 
informations au Manuel utilisateur de l'oscilloscope a mémoire 
numérique TDSIOO0B et TDS2000B. 


Les menus suivants ont été modifiés : 


e Le menu Affichage comprend l'option Style d'affichage. L'option 
Style d'affichage a été déplacée du menu UTILITAIRE P Options. 


e Le menu UTILITAIRE > Options comprend une option permettant 
de configurer le port USB arriére. 


Pour configurer le port USB 4 l'arriére de l'oscilloscope, appuyez sur le 
bouton d'option UTILITAIRE » Options ® Rear USB Port (port USB 
arriére) et sélectionnez l'un des réglages suivants : 


e L'option Ordinateur permet de définir l'oscilloscope pour 
communiquer avec un ordinateur. 


e L'option Imprimante permet de définir l'oscilloscope pour 
communiquer avec une imprimante compatible PictBridge. 


e L'option Détection auto (réglage par défaut) permet a I'oscilloscope 
de configurer automatiquement le port pour un ordinateur ou une 
imprimante. 


REMARQUE. L'adaptateur GPIB et certains systémes d'exploitation 
peuvent ne pas fonctionner correctement avec la fonction de détection 
automatique. 


L'oscilloscope conserve le réglage du port USB arriére jusqu'a sa 
modification, méme si vous appuyez sur le bouton CONF. PAR D. ou 
si vous mettez l'oscilloscope hors tension. 
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2 Séries TDS1000B and TDS2000B 


Informazioni preliminari 


Informazioni preliminari sugli oscilloscopi 
TDS1000B e TDS2000B 


Conservare le pagine successive per future consultazioni. Allegare 
queste informazioni al manuale dell’utente dell’oscilloscopio a 
memoria digitale serie TDS1000B e TDS2000B. 


Sono state apportate delle modifiche ai seguenti menu: 


e Il menu Visualizza include |’ opzione Visualizza stile. L’ opzione 
Visualizza stile é stata spostata dal menu UTILITY ® Opzioni. 


e Ilmenu UTILITY ® Opzioni dispone di un'opzione per configurare 
il Rear USB Port. 


Per configurare la porta USB sul retro dell’ oscilloscopio, premere il 
pulsante UTILITY ® Opzioni ® Rear USB Port (porta USB sul retro) 
e scegliere una delle seguenti impostazioni: 


e La selezione del computer imposta la comunicazione tra 
oscilloscopio e computer. 


e La selezione della stampante imposta la comunicazione tra 
l’oscilloscopio e una stampante compatibile con PictBridge. 


e Laselezione Rilevamento automatico (predefinita) consente che 
lV’ oscilloscopio configuri automaticamente la porta del computer o 
della stampante. 


NOTA. L’adattatore GPIB e alcuni sistemi operativi per computer 
potrebbero non funzionare correttamente con la selezione Rilevamento 
automatico. In questo caso, modificare le impostazioni del computer. 


Fino a successive modifiche |’ oscilloscopio consente di memorizzare 
l’impostazione Rear USB Port (porta USB sul retro), anche se si preme 
il pulsante IMP. PREDEF. o si spegne l'oscilloscopio. 
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Bitte zuerst lesen 


TDS1000B und TDS2000B Bitte zuerst lesen 


Bitte speichern Sie diese Seiten, um spater darin nachlesen zu konnen. 
Fiigen Sie diese Informationen dem Benutzerhandbuch fiir das 
Digital-Phosphor-Oszilloskop der Serie TDS1000B und TDS2000B 
hinzu. 


Die folgenden Meniis wurden geandert: 


e Das Menii Display enthalt die Option Darstellart. Die Option 
Darstellart wurde vom Menti DIENSTPGM. ® Optionen 
verschoben. 


e Das Menii DIENSTPGM. » Optionen enthalt eine Option zum 
Konfigurieren des USB-Anschlusses auf der Riickseite. 


Driicken Sie zum Konfigurieren des USB-Anschlusses auf der 
Riickseite des Oszilloskops die Optionstaste DIENSTPGM. > 
Optionen ® Rear USB Port (USB-Anschluss auf der Riickseite), und 
wahlen Sie eine der folgenden Einstellungen aus: 


e Bei aktivierter Option Computer wird das Oszilloskop auf die 
Kommunikation mit einem Computer festgelegt. 


e Bei Auswahl der Option Drucker wird das Oszilloskop auf die 
Kommunikation mit einem PictBridge-kompatiblen Drucker 
festgelegt. 


e Die Auswahl von Auto. Erfass. (Standard) veranlasst, dass das 
Oszilloskop den Anschluss fiir einen Computer oder fiir einen 
Drucker automatisch konfiguriert. 


HINWEIS. Der GPIB Adapter und einige Computerbetriebssysteme 
funktionieren méglicherweise nicht wunschgemdp bei aktivierter Auto. 
Erfass. Wenn dies zutrifft, wahlen Sie stattdessen die Einstellung 
Computer. 


Das Oszilloskop speichert die Einstellung Rear USB Port 
(USB-Anschluss auf der Riickseite), bis Sie von Ihnen geandert wird. 
Die Einstellung bleibt erhalten, auch wenn die Taste 
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GRUNDEINSTELLUNG gedriickt wird oder das Oszilloskop 
ausgeschaltet wird. 


2 Serie TDS1000B and TDS2000 


Lea esto primero 


TDS1000B y TDS2000B Lea esto primero 


Guarde estas paginas para futuras consultas. Afiada esta informacion al 
Manual del usuario del osciloscopio de memoria digital TDSIO00B y 
TDS2000B. 


Los siguientes mentis han cambiado: 


e El mend Pantalla incluye la opci6n Estilo pantalla. La opci6n Estilo 
pantalla se ha eliminado del ment UTILIDADES ® Opciones. 


e El ment UTILIDADES P Opciones incluye una opcidn para 
configurar el puerto USB trasero. 


Para configurar el puerto USB en la parte posterior del osciloscopio, 
pulse el bot6n de pantalla UTILIDADES P Opciones ® Rear USB 
Port (puerto USB trasero) y seleccione una de las opciones siguientes: 


e Laseleccién Ordenador configura el osciloscopio para la 
comunicacion con un ordenador. 


e La seleccién Impresora configura el osciloscopio para la 
comunicaci6n con una impresora compatible con PictBridge. 


e Laseleccion Autoconfigurar (predeterminada) configura 
automaticamente el puerto del osciloscopio para un ordenador o 
para una impresora. 


NOTA. El adaptador GPIB y algunos sistemas operativos pueden no 
funcionar correctamente con la seleccién Autoconfigurar. Si éste es el 
caso, cambie la seleccién a Ordenador. 


El osciloscopio guarda la opcidn Rear USB Port (puerto USB trasero) 
hasta que la cambie, incluso si pulsa el bot6n CONFIG. PREDETER. o 
apaga el osciloscopio. 
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Salve essas pAginas para consultas futuras. Adicione essas informacGées 
ao Manual do usuario do Osciloscépio de armazenamento digital das 
séries TDS1000B e TDS2000B. 


Os seguintes menus foram alterados: 


e O menu Display inclui a opcao Cores Display. A opcao Cores 
Display saiu do menu UTILITARIO ® Opcées. 


e¢ Omenu UTILITARIO & Opcoes contém uma op¢ao para 
configurar a porta USB na parte traseira do osciloscépio. 


Para configurar a porta USB na parte traseira do osciloscépio, 
pressione 0 botao de op¢ao UTILITARIO & Opcoées ® Rear USB Port 
(porta USB na parte traseira) e selecione uma das configuracGes a 
seguir: 


e A selegao Computador determina que 0 osciloscépio se comunique 
com um computador. 


e A selecao Impressora determina que 0 oscilosc6pio se comunique 
com uma impressora compativel com PictBridge. 


e A selegao Detecgao Automatica (padrao) permite que o 
osciloscépio configure automaticamente a porta para um 
computador ou uma impressora. 


OBSERVACAO O adaptador GPIB e alguns sistemas operacionais 
podem nao funcionar como esperado com a selecdo de Deteccdo 
Automatica. Nesse caso, mude a configuragado para Computador. 


O oscilosc6pio armazena a configuracao da Rear USB Port (porta USB 
na parte traseira) até que seja alterada, mesmo se 0 botao CONF. 
PADRAO for pressionado ou se 0 Osciloscépio for desligado. 
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HeooOxonmMple cBezeHun 


Heo6xogumble cBegeHua o Mogenax 
TDS1000B u TDS2000B 


CoxpaHute 9TH CTpaHHUbl, YTOOBI HCHOMb3OBaTh JIA CIpaBKH B 
Oyaylem. Betapbte sTy HHpopMalnW B PyKxogodcméo nolbz06amenA 
yuqbpo6ozo 3anomunaroyezo ocyunlozepada cepuu TDS1000B u 
TDS2000B. 


VM3mMeHeHbI CJICHYIOMNIMe MCHEHO. 


-e Mento SKPAH pxmouaer onumro Display Style (Crumb skpana). 
Onna Display Style (Crum skpaHa) MepemMeneHa 13 MeHIO 
CEPBUC > Options (Onunn). 


e Mento CEPBUC > Options (Ontmun) Bkmrouaer onmHto WA 
HacTpouku nopta USB ua 3aqHei NaHemn. 


Jia Hactpoliku nopta USB ua 3agHeli Manes ocuMNorpada 
BbIOepute CEPBUC > Options (Onunun) > Rear USB Port (3annnit 
‘tlopt USB), a 3aTem BBIOepuTe OFHO M3 CUeAyIOWMXx 3Ha4yeHUi. 


e IIpu Bri0ope Computer (Kommprotep) ocimitorpad HaynHaert 
yCTaHaBJIMBaTb CBA3b C KOMIIbIOTepOM. 


e IIpu BerOope Printer (IIpuutep) ocimmnorpad HaywHaet 
ycTaHaBJIMBaTb CBxA3b C PictBridge-coBMecTHMBIM IIpHHTepoM. 


e [lapamertp Auto Detect (aproBniOop) - IPHHATHI MO yMosMaHHt0 - 
MO3BOJAeT OCLIMIIOrpady aBTOMaTH4eCKH HacTpauBaThb MOpT AIA 
OOMeHAa JlaHHBIMH C KOMITbIOTEPOM HJM IIpHHTepoM. 


ITPHMEWAHHE. Adanmep GPIB u nexomopeie KomnoiomepHvle 
OnepayuonHole CucmembI Mozym He pabomamb HadnercaujuM 
o6pazom npu 6vibope Auto Detect (Aemoo6uapyocenue). B 2mom 
cayuae uzmMenume 3Hayenue Ha Computer (Komnoiomep). 


3Hayenne Jud Rear USB Port (3aqHuit nopr USB) coxpansertca 
OcIMUIOrpadom, oka He Gy eT U3MeHEHO, JaxKe NIpH HaxKaTHH 
kHonku HACTPOMKA TIO YMOJISAHHIO wim orkmouennn 
MMTanuA OcUMIWIOrpada. 
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Command Descriptions 


Arguments 


<NR3> is the position in seconds. This value is the difference between 
the trigger point and the center graticule. Positive values place the 
trigger before the center graticule. 


Examples 
HORIZONTAL:MAIn:POSition 2.0E-6 
sets the main trigger position to 2 us before the center graticule. 


HORIZONTAL:MAIn: POSi tion? 
might return -1.0E-3, indicating that the main trigger position is 1 
ms after the center graticule. 


Related Commands 
HORizontal: DELay:POSition 


HORizontal:MAIn:SCAle 


Sets the time per division for the main time base. This command is 
equivalent to setting SEC/DIV when Main is selected from the 
Horizontal menu. 


Group 
Horizontal 


Syntax 
HORi zontal :MAIn:SCAle <NR3> 


HORi zontal :MAIn:SCAle? 


Arguments 


<NR3> is the time per division. The range is 5 ns to5 sina 1-2.5-5 
sequence. 


Examples 


HORIZONTAL:MAIN:SCALE 2.5E-6 
sets the main scale to 2.5 us per division. 


TDS 200-Series Programmer Manual 2-99 


Command Descriptions 


- Related Commands 
HORizontal: DELay:SCAle, HORizontal: DELay:SECdiv, HORizon- 
tal: MAIn:SECdiv 


HORizontal:MAIn:SECdiv 


Sets the time per division for the oscilloscope main time base. This 
command is identical to the HORizontal:MAIn:SCAle command. It 
is provided to maintain program compatibility with some older 
models of Tektronix oscilloscopes. 


Group 
Horizontal 


Syntax 
HORizontal:MAIn:SECdiv <NR3> 


HORi zontal :MAIn:SECdiv? 


Arguments 


<NR3> is the time per division. The range is 5 ns to 5 s in a 1-2.5-5 
sequence. Values that are not in a 1-2.5-5 sequence are set to the 
closest valid value. 


Examples 


HORIZONTAL:MAIN:SECdiv 2.5E-6 
sets the main scale to 2.5 us per division. 


Related Commands 


HORizontal:DELay:SCAle, HORizontal: DELay: SECdiv, HORizon- 
tal:MAIn:SCAle 
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HORizontal:POSition 


Sets or queries the main time base horizontal position. This 
command is identical to the HORizontal:MAIn:POSition command. 
This command is included for compatibility. 


Group 
Horizontal 


Syntax 
HORizontal:POSition <NR3> 


HORizontal:POSition? 


Arguments 

<NR3> is the position in seconds. This value is the difference between 
the trigger point and the center graticule. Positive values place the 
trigger before the center graticule. 


Examples 
HORIZONTAL: POSition 2.0E-6 
sets the main trigger position to 2 us before the center graticule. 


HORIZONTAL: POSi tion? 
might return -1.0E-3, indicating that the main trigger position is 1 
ms after the center graticule. 


Related Commands 
HORizontal: DELay:POSition, HORizontal:MAIn:POSition 
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HORizontal:RECOrdlength? (Query Only) 


Returns the number of record data points. For TDS 200-series 
oscilloscopes this value is always 2500. This command is provided to 
maintain program compatibility with other TDS-series oscilloscopes. 


Group 
Horizontal 


Syntax 
HORi zontal :RECOrd]ength? 


Returns 
2500 


Examples 


HORIZONTAL: RECOrdlength? 
returns 2500 as the number of data points in each record. 


Related Commands 
None 


HORizontal:SCAle 


Sets the time per division for the main time base and is identical to 
the HORizontal:MAIn:SCAle command. It is included for compati- 
bility purposes. 


Group 
Horizontal 


Syntax 
HORizontal:SCAle <NR3> 


HORi zontal :SCAle? 
Arguments 


<NR3> is the time per division. The range is 5 ns to 5s in a 1-2.5-5 
sequence. 
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Examples 
HORIZONTAL: SCALE 2.5E-6 
sets the main scale to 2.5 us per division. 


Related Commands 
HORizontal:MAIn:SCAle 


HORizontal:SECdiv 


Sets the time per division for the main time base and is identical to 
the HORizontal:MAIn:SCAle command. It is included for compati- 
bility purposes. 


Group 
Horizontal 


Syntax 
HORizontal:SECdiv <NR3> 


HORi zontal :SECdiv? 


Arguments 
<NR3> is the time per division. The range is 5 ns to5.s ina 1-2.5-5 
sequence. 


Examples 
HORIZONTAL:SECdiv 2.5E-6 
sets the main scale to 2.5 us per division. 


Related Commands 
HORizontal:MAIn:SCAle 
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HORizontal:VIEw 


Specifies whether the horizontal display uses the main, window 
zone, or window view. This is equivalent to setting the View in the 
Horizontal menu. . 


Group 
Horizontal 


Syntax 
HORizontal:VIEw { MAIN | WINDow | ZONE } 


HORi zontal :VIEw? 


Arguments 


MAIN specifies that the waveform is horizontally scaled relative to 
the main time base. 


WINDow specifies that the waveform is horizontally scaled relative to 
the window (delay) time base. 


ZONE specifies that the portion of the waveform that is within the 
vertical cursor bars is acquired through the window (delay) time 
base. 


Examples 

HORIZONTAL: VIEw MAIN 

specifies that the waveform is horizontally scaled relative to the main 
time base. 
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ID? (Query Only) 


Returns identifying information about the instrument and its 
firmware in Tektronix Codes and Formats notation. 


NOTE. ID? must be the last command when it is part of a concate- 
nated statement. Otherwise the oscilloscope generates event 
message 440. 


Group 
Status and Events 


Syntax 
ID? 


Returns 
The instrument identification in the following format: 


TEK/<model number>,CF:91.1CT,FV:<oscilloscope firmware 
version number>, TDS2XX:XXV:<module firmware version 
number> 

Where XX is the module type (HM for Hard Copy Module, CM for 
Communications Module, or MM for Measurement Module). 


Examples 
ID? 
might return TEK/TDS 220,CF:91.1CT,FV:1.00 TDS2CM:CMV:1.00 


Related Commands 
*IDN? 


TDS 200-Series Programmer Manual 2-105 


Command Descriptions 


*IDN? (Query Only) 


Returns the oscilloscope identification code in IEEE 488.2 notation. 


NOTE. IDN? must be the last command when it is part of a 
concatenated statement. Otherwise the oscilloscope generates event 
message 440. 


Group 
Status and Events 


Syntax 
*IDN? 


Returns 
The instrument identification in the following format: 


TEKTRONIX,<model number>,0,CF:91.1CT FV:<oscilloscope 
firmware version number> TDS2XX:XXV:<module firmware 
version number> 

Where XX is the module type (HM for Hard Copy Module, CM for 
Communications Module, or MM for Measurement Module). 


Examples 

*IDN? 

might return the response 

TEKTRONIX,TDS 220,0,CF:91.1CT FV:1.00 TDS2CM:CMV:1.00 


Related Commands 
ID? 
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LANGuage 


Sets or queries the languages that the oscilloscope uses to display 
information on the screen. This is equivalent to the Language 
selection in the Utility menu. 


Group 
Miscellaneous 


Syntax 


LANGuage { ENGLish | FRENch | GERMan | ITALian | 
PORTUguese | SPANish | JAPAnese | KOREan | 
TRADitionalchinese | SIMPlifiedchinese } 


LANGuage? 


Arguments 


The argument specifies which language will be used to display 
oscilloscope information on the screen. 


Examples 
LANGuage FRENch 
specifies that the oscilloscope display information in French. 


LANGuage? 
might return SPANi sh. 


Related Commands 
None 
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LOCk 


Enables and disables all front-panel buttons and knobs. There is no 
front-panel equivalent. 


Group 
Miscellaneous 


Syntax 

LOCk { ALL | NONe } 

LOCk? 

Arguments 

ALL disables all front-panel controls. 


NONe enables all front-panel controls. This is equivalent to the 
UNLock ALL command. 


Examples 


LOCK ALL 
locks the front-panel controls. 


LOCK? 
returns NONE when the front-panel controls are enabled by this 
command. 


Related Commands 
UNLock 
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*LRN? (Query Only) 


Returns a string listing the oscilloscope settings, except for 
calibration configuration information. You can use this string to 
return the oscilloscope to the state it was in when you sent the 
*LRN? command. 


Group 
Miscellaneous 


Syntax 
*LRN? 


NOTE. *LRN? always returns a string including command headers, 
regardless of the setting of the HEADer command. This is because 
the returned string is intended to be sent back to the oscilloscope as 
a command string. The VERBos command can Still be used normally 
to specify whether the returned headers should be abbreviated. 


Returns 
None 


Examples 

*LRN? 

a partial response might look like this: 

ACQUIRE: STATE 1;MODE SAMPLE;NUMAVG 16; 

STOPAFTER RUNSTOP;STATE 1;:HEADER 1;:VERBOSE 1; 
:CURSOR: FUNCTION OFF;VBARS: UNITS SECONDS; POSITION1 
1.00E-6;POSITION2 9.00E-6 


Related Commands 
HEADer, SET?, VERBose 
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MATH? (Query Only) 
Returns the definition for the math waveform. 


Group 
Vertical 


Syntax 
MATH? 


Returns 
Definition for the math waveform. 


Examples 

MATH? 

returns :MATH:DEFINE "CH1 + CH2" if the math waveform is 
defined as channel 1 plus channel 2. 


Related Commands 
MATH:DEFINE 


MATH:DEFINE 


Performs the specified mathematical operation on the input signal or 
signals. To turn the math waveform on or off, use the SELect:<wfm> 
command (page 2-138) . 


Group 
Vertical 


Syntax 
MATH:DEFINE <QString> 


MATH: DEFINE? 
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Arguments 
<QString> specifies a math waveform, and can be one of the 
following: 


CH1-CH2 (Not available with TDS2MM: refer to CH<x>:INVert) 
CH2-CH1 (Not available with TDS2MM: refer to CH<x>:INVert) 
CH1+CH2 

-CH1 (Not available with TDS2MM: refer to CH<x>:INVert) 
-CH2 (Not available with TDS2MM: refer to CH<x>:INVert) 
FFT (CH<x> [, <window>]) (TDS2MM Only) 


Where the optional <window> argument is HANning, FLATtop, or 
RECTangular. 


Remember that <QString> must be enclosed in quotes. You can use 
white spaces between words. 


Examples 

MATH:DEFINE "CH1+CH2" 

sets the math waveform so that it displays the sum of channel 1 and 
channel 2. 


MATH:DEFINE "FFT (CH1, HANNING)" 
sets the math waveform to display an FFT of channel | using a 
Hanning window. 


Related Commands 
MATH? 


MATH: FFT:HORizontal:POSition (TDS2MM Only) 


Sets or queries the FFT math waveform horizontal position. 


Group 
Horizontal 


Syntax 


MATH: FFT: HORi zontal :POSition <NR3> 
MATH: FFT: HORi zontal :POSition? 
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_ Arguments 
<NR3> specifies the point in the FFT waveform data record to display 
at the center vertical graticule line. The data record point is a 
percentage of the total record length, in the range of 0 to 100. The 
default value is 50. How much data is displayed depends on the FFT 
Zoom factor setting. The oscilloscope rounds <NR3> to the nearest 
workable value. 


Examples 

MATH: FFT :HORIZONTAL: POSITION 25 

sets the FFT waveform horizontal position such that the data at the 
25% point of the record is centered on the display. 


MATH: FFT: HORIZONTAL: POSITION? 
might return 50, indicating that the 50% point in the data record is 
horizontally centered on the display. 


Related Commands 
MATH:FFT:HORizontal:SCAle 


MATH:FFT:HORizontal:SCAle (TDS2MM Only) 


Sets or queries the FFT math waveform horizontal zoom factor. 


Group 
Horizontal 


Syntax 
MATH: FFT:HORizontal :SCAle <NR3> 
MATH: FFT :HORi zontal :SCAle? 


Arguments 

<NR3> specifies the horizontal magnification factor, where the axis of 
magnification is the center vertical graticule line. Valid zoom factors 
are 1, 2, 5, and 10. If other values are entered the oscilloscope rounds 
the value of <NR3> to the nearest valid zoom factor. 
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Examples 
MATH: FFT: HORIZONTAL:SCALE 5 
sets the FFT waveform horizontal zoom factor to X5. 


MATH: FFT: HORIZONTAL: SCALE? 
might return 2, indicating that the zoom factor setting is X2. 


Related Commands 
MATH:FFT:HORizontal:POS ition 


MATH:FFT:VERtical:POSition (TDS2MM Only) 


Sets or queries the FFT math waveform vertical position. 


Group 
Vertical 


Syntax 
MATH: FFT: VERtical:POSition <NR3> 
MATH: FFT: VERtical:POSition? 


Arguments 
<NR3> specifies the FFT waveform vertical position in divisions. 


Examples 

MATH: FFT: VERTICAL: POSITION 2 

sets the FET waveform vertical position to 2 major divisions above 
the center horizontal graticule line. 


MATH: FFT: VERTICAL: POSITION? 
might return 5, indicating that the FFT waveform 0 reference point is 
5 major divisions from the center horizontal graticule line. 


Related Commands 
MATH:FFT:VERtical:SC Ale 
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MATH:FFT:VERtical:SCAle (TDS2MM Only) 


Sets or queries the FFT math waveform vertical zoom factor. 


Group 
Vertical 


Syntax 


MATH: FFT: VERtical:SCAle <NR3> 
MATH: FFT: VERtical:SCAle? 


Arguments 

<NR3> specifies the vertical zoom factor, where the axis of 
magnification is the center horizontal graticule line. Valid zoom 
factors are 0.5, 1, 2, 5, and 10. If other values are entered the 
oscilloscope rounds the value of <NR3> to the nearest valid zoom 
factor. 


Examples 
MATH: FFT: VERTICAL:SCALE 5 
sets the FFT waveform vertical zoom factor to X5. 


MATH: FFT: VERTICAL: SCALE? 
might return 2, indicating that the zoom factor setting is X2. 


Related Commands 
MATH:FFT: VERtical:POSition 
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MEASUrement? (Query Only) 


Returns all oscilloscope measurement parameters. 


Group 
Measurement 


Syntax 
MEASUrement? 


Returns 
Oscilloscope measurement parameters 


Examples 
MEASUREMENT? 
might return the following: 


MEASUREMENT :MEAS1: TYPE PERIOD; 

UNITS "s";SOQURCE CH1; :MEASUREMENT :MEAS2 

:TYPE FREQUENCY ;UNITS "Hz" ;SOURCE CH1; 

:MEASUREMENT :MEAS3: TYPE PK2PK;UNITS "V";SOURCE CH1; 
:MEASUREMENT :MEAS4: TYPE MEAN;UNITS "V";SOURCE CH1; 
:MEASUREMENT: IMMED: TYPE CRMS;UNITS "V";SOURCE CH1 


Related Commands 
None 


MEASUrement:IMMed? (Query Only) 


Returns all immediate measurement setup parameters. 


Group 
Measurement 


Syntax 
MEASUrement : IMMed? 
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Returns 
Immediate measurement setup parameters 


Examples 

MEASUREMENT : IMMED? 

might return :MEASUREMENT: IMMED: TYPE PERIOD;UNITS “s"; 
SOURCE CH1 


Related Commands 
None 


MEASUrement:IMMed:SOuUrce 


Sets or queries the source for all immediate measurements. 


Group 
Measurement 


Syntax 
MEASUrement : IMMed:SOUrce CH<x> 


MEASUrement : IMMed:SOUrce? 


Arguments 
CH<x> is an input channel. 


Examples 
MEASUREMENT: IMMED: SOURCE CH1 


specifies channel 1 as the immediate measurement source. 


Related Commands 
None 
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MEASUrement:IMMed:TYPe 


Sets or queries the immediate measurement type. 


Group 
Measurement 


Syntax 


MEASUrement:IMMed:TYPe { FREQuency | MEAN | PERIod | 
PK2pk | CRMs | RISe | FALL | PWIdth | NWIdth} 


MEASUrement : IMMed:TYPe? 


Arguments 
FREQuency is the reciprocal of the period measured in Hertz. 


MEAN is the arithmetic mean over the entire waveform. 


PERIod is the time, in seconds, it takes for one complete signal cycle 
to happen. 


PK2pk is the absolute difference between the maximum and 
minimum amplitude. 


CRMs is the true Root Mean Square voltage over one cycle. 


RISe (TDS2MM Only) is the rise time between 10% and 90% of the 
first rising edge of the waveform. Rising edge must be displayed to 
measure. The TDS2MM automatically calculates the 10% and 90% 
measurement points. 


FALL (TDS2MM Only) is the fall time between 90% and 10% of the 
first falling edge of the waveform. Falling edge must be displayed to 
measure. The TDS2MM automatically calculates the 10% and 90% 
measurement points. 


PWIdth (TDS2MM Only) is the positive pulse width between the 
first rising edge and the next falling edge at the waveform 50% level. 
Rising and falling edges must be displayed to measure. The 
TDS2MM automatically calculates the 50% measurement point. 
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NWIdth (TDS2MM Only) is the negative pulse width between the 
first falling edge and the next rising edge at the waveform 50% level. 
Falling and rising edges must be displayed to measure. The 
TDS2MM automatically calculates the 50% measurement point. 


Examples 
MEASUREMENT: IMMED: TYPE FREQUENCY 
defines the immediate measurement to be a frequency measurement. 


Related Commands 
None 


MEASUrement:IMMed:UNIts? (Query Only) 


Returns the units for the immediate oscilloscope measurement. 


Group 


Measurement 


Syntax 
MEASUrement : IMMed:UNIts? 


Returns 
<QString> returns "V" for volts, "s" for seconds, or "Hz" for hertz. 


Examples 

MEASUREMENT : IMMED: UNITS? 

might return "s", indicating that the unit for the immediate 
measurement is seconds. 


Related Commands 
MEASUrement:IMMed:TY Pe 
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MEASUrement:IMMed:VALue? (Query Only) 


Executes the immediate oscilloscope measurement specified by the 
MEASUrement:IMMed:TY Pe command. The measurement is taken 
on the source specified by the MEASUrement:IMMed:SOUrce 
command. iy 


In order to see if the measurement was successful, use the *ESR? 
and EVENT? commands to read the Standard Event Status Register 
(SESR). If the channel specified by MEASUrement:IMMed:SOUrce 
is not currently displayed, the oscilloscope generates event 2225 and 
returns 9.9E37. 


NOTE. If trigger view is active, scan mode is in effect, or the display 
format set to XY, this query returns 9.9E37 and generates event 221 
(Settings conflict). 


Group 
Measurement 


Syntax 
MEASUrement : IMMed: VALue? 


Returns 
<NR3> 


Examples 
MEASUrement : IMMed: VALue? 


might return 28.75E6 if you are measuring the frequency of a 
28.75 MHz signal. 


MEASUrement : IMMed: VALue? 
might return 9.9E37, which means that the channel specified by 
MEASUrement:IMMed:SOUrce is not currently displayed. 


Related Commands 
None 
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MEASUrement:MEAS<x>? (Query Only) 


Returns all measurement parameters for the displayed oscilloscope 
periodic measurement specified by <x>, where <x> is 1 through 4. 


Group 
Measurement 


Syntax 
MEASUrement :MEAS<x>? 


Returns 
Settings for the specified measurement source. 


Examples 

MEASUREMENT :MEAS3? 

might return :MEASUREMENT :MEAS3: TYPE PERIOD; 
UNITS "s";SOURCE CHI. 


Related Commands 
None 


MEASUrement:MEAS<x>:SOUrce 


Sets or queries the source for the measurement. This is equivalent to 
selecting the measurement source in the MEASURE menu. 


Group 
Measurement 


Syntax 
MEASUrement :MEAS<x>:SOUrce { CH1 | CH2 } 


MEASUrement :MEAS<x>:SO0Urce? 


Arguments 
CH1 or CH2 specifies the measurement source channel. 
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Examples 
MEASUREMENT :MEAS2:SOURCE CH1 
Sets the source of MEAS2 to channel 1. 


Related Commands 
None 


MEASUrement:MEAS<x>:TYPe 


Sets or queries the oscilloscope measurement type for the measure- 
ment specified by <x>. This is equivalent to selecting the measure- 
ment type in the MEASURE menu. Setting the type to anything 
other than NONE displays the MEASURE menu on the screen. 


Group 
Measurement 


Syntax 
MEASUrement :MEAS<x>:TYPe { FREQuency | MEAN | PERIod | 
PK2pk | CRMs | RISe | FALL | PWIdth | NWIdth | NONE } 


MEASUrement :MEAS<x>: TYPe? 


Arguments 
FREQuency is the reciprocal of the period measured in Hertz. 
MEAN is the arithmetic mean over the entire waveform. 


PERIod is the time, in seconds, it takes for one complete signal cycle 
to happen. 


PK2pk is the absolute difference between the maximum and 
minimum signal amplitude. 


CRMs is the true Root Mean Square value over one waveform cycle. 


RISe (TDS2MM Only) is the rise time between 10% and 90% of the 
first rising edge of the waveform. Rising edge must be displayed to 
measure. The TDS2MM automatically calculates the 10% and 90% 
measurement points. 
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FALL (TDS2MM Only) is the fall time between 90% and 10% of the 
first falling edge of the waveform. Falling edge must be displayed to 
measure. The TDS2MM automatically calculates the 10% and 90% 
measurement points. 


PWIdth (TDS2MM Only) is the positive pulse width between the 
first rising edge and the next falling edge at the waveform 50% level. 
Rising and falling edges must be displayed to measure. The 
TDS2MM automatically calculates the 50% measurement point. 


NWIdth (TDS2MM Only) is the negative pulse width between the 
first falling edge and the next rising edge at the waveform 50% level. 
Falling and rising edges must be displayed to measure. The 
TDS2MM automatically calculates the 50% measurement point. 


NONE disables the measurement specified by <x>. 
Examples 
MEASUREMENT :MEAS3: TYPE CRMS 


specifies MEAS3 to calculate the true Root Mean Square vaiue. 


Related Commands 
None 


MEASUrement:MEAS<x>:UNIts? (Query Only) 


Returns the units for the oscilloscope measurement specified by 
MEASUrement:MEAS<x>:TYPe. 


Group 
Measurement 


Syntax 
MEASUrement :MEAS<x>:UNIts? 


Returns 
<QString> returns "V" for volts, "s" for seconds, or "Hz" for hertz. 
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Examples 
MEASUREMENT :MEAS3: UNITS? 
might return "V", indicating the units for measurement 3 are volts. 


Related Commands 
None 


MEASUrement:MEAS<x>:VALue? (Query Only) 


Returns the value that has been calculated for the oscilloscope 
measurement specified by <x>. 


This value is a display value and will be updated about every 1/2 
second if both the MEASURE menu and the MEAS<x> source 
channel are displayed. If you are acquiring at a slow sweep rate, the 
oscilloscope may take longer than 1/2 second to update. MEASure- 
ment: IMMED is usually more useful than MEASUrement:MEAS<x> 
when using the oscilloscope with external devices. 


If MEASUrement:MEAS<X>:TYPe is set to NONE, MEAS Ure- 
ment: MEAS<X>:VALue? generates event message 2231 (Measure- 
ment error, measurement is not turned on) and returns 9.9E37. 


If the channel specified by MEAS Urement:MEAS<X>:SOUtce is 
not displayed on the oscilloscope, the oscilloscope generates event 
message 2225 (Measurement error, no waveform to measure) and 

returns 9.9E37. 


NOTE. If trigger view is active, scan mode is in effect, or the display 
format set to XY, this query generates event 221 (Settings conflict) 
and returns 9.9E37. 


Group 
Measurement 


Syntax 
MEASUrement :MEAS<x>:VALue? 


TDS 200-Series Programmer Manual 2-123 


Command Descriptions 


Returns 
<NR3> 


Examples 
MEASUrement :MEAS3: VALue? 
might return 28.75E6 if measurement number three is frequency. 


Related Commands 
None 


*OPC 


Generates the operation complete message in the Standard Event 
Status Register (SESR) when all pending operations finish. The 
*OPC? query places the ASCII character “1” into the output queue 
when all pending operations are finished. The *OPC? response is not 
available to read until all pending operations finish. 


The *OPC command lets you synchronize the operation of ihe 
oscilloscope with your application program. Synchronization 
methods are described starting on page 3-10. 


For a complete discussion of the use of these registers and the output 
queue, refer to page 3-1. Table 2—22 lists commands that generate an 
operation complete message. 


Table 2-22: Commands that generate an Operation Complete 


message 

Command Operation 

*CAL?, CALibrate: CONTINUE, Internal self-calibration 
CALIbrate:FACtory, CALIbrate:INTERNAL 

ACQuire:STATE ON or Busy single sequence 
ACQuire:STATE RUN acquisition 

(when ACQuire:STOPAfter is set to SEQuence) 

HARDCopy STARt Busy hardcopy output 

Group 


Status and Error 
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Syntax 
£0PC 


*OPC? 


Arguments 
None 


Examples 
*OPC? 
might return a 1, which indicates that the operation is complete. 


Related Commands 
BUSY?, *WAI 


Sets and queries the power-on status flag that controls the automatic 
power-on handling of the DESER, SRER, and ESER registers. When 
*PSC is true, the DESER register is set to 255 and the SRER and 
ESER registers are set to 0 at power on. When *PSC is false, the 
current values in the DESER, SRER, and ESER registers are 
preserved in nonvolatile memory when power is shut off and are 
restored at power on. For a complete discussion of the use of these 
registers, see page 3-1. 


Group 
Status and Error 


Syntax 
*PSC <NR1> 


BESCE 
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_ Arguments 


<NR1> = 0 sets the power-on status clear flag to false, disables the 
power on clear, and allows the oscilloscope to possibly assert SRQ 
after power on. 


<NR1> 0 sets the power-on status clear flag true. Sending *PSC 1, 
therefore, enables the power-on status clear and prevents any SRQ 
assertion after power on. 


Examples 


Pola 
sets the power-on status clear flag to false. 


ZPSCe 
might return the value 1, showing that the power-on status clear flag 
is set to true. 


Related Commands 
DESE, *ESE, FACtory, *RST, *SRE 


*RCL (No Query Form) 


Restores the state of the oscilloscope from a copy of its settings 
stored in memory. (The settings are stored using the *SAV com- 
mand.) This command is equivalent to RECAII:SETUp, and 
performs the same function as the Recall Saved Setup item in the 
front-panel Save/Recall Setup menu. 


Group 
Save and Recall 


Syntax 
*RCL <NR1> 


Arguments 


<NR1> is an integer value in the range from 1 to 5, and specifies a 
setup storage location. 
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Examples 

PRC 

restores the oscilloscope from a copy of the settings stored in 
memory location 3. 


Related Commands 
FACtory, *LRN?, RECAI:SETUp, *RST, *SAV, SAVe:SETUp 


RECAII:SETUp (No Query Form) 


Restores a stored or factory front-panel setup of the oscilloscope. 
This command is equivalent to selecting Recall Setup or Recall 
Factory in the Save/Recall Setup menu. 


Group 
Save and Recall 


Syntax 
RECA11:SETUp { FACtory | <NRI1> } 


Arguments 
FACtory selects the factory setup. 


<NR1> is a value in the range from 1 to 5 and specifies a setup 
storage location. 


Examples 
RECALL: SETUP FACTORY 


recalls the front-panel setup to its factory defaults. 


Related Commands 
FACtory, *RCL, *RST, *SAV, SAVe:SETUp 
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REM (No Query Form) 


Specifies a comment. This line is ignored by the instrument. 


Group 
Miscellaneous 


Syntax 
REM <QString> 


Arguments 
<QString> is a string that can have a maximum of 80 characters. 


Examples 
REM "This is a comment" 
is ignored by the instrument. 


Related Commands 
None 


RS232? (Query Only) 


2-128 


Queries the RS232 settings. 


Group 
RS-232 


Syntax 
RS232? 


Returns 
The current RS-232 settings 


Examples 

RS232? 

might return: RS232:BAUD 9600; SOFTFLAGGING 0; 
HARDFLAGGING 1; PARITY NONE; TRANSMIT: TERMINATOR LF 


TDS 200-Series Programmer Manual 


Command Descriptions 


Related Commands 


RS232: BAUD, RS232: HARDFLagging, RS232: PARity, 
RS232:SOFTFLagging 


RS232:BAUd 


Sets or queries the RS-232-C interface transmission speed. If no flow 
control (flagging) is used, commands may be received faster than the 
oscilloscope can process them. Also, if another command is sent 
immediately after this command, without waiting for the baud rate to 
be programmed, the first couple of characters may be lost. 


Group 
RS-232 


Syntax 
RS232:BAUd <NR1> 


RS232:BAUd? 


Arguments 


<NR1> where <NR1> can be 300, 600, 1200, 2400, 4800, 9600, or 
19200. 


Examples 
RS232:BAUD 9600 
sets the transmission rate to 9600 baud. 


Related Commands 


RS232: HARDFlagging, RS232: PARity, RS232:SOFTFlagging, 
RS232? 
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RS232:HARDFlagging 


Sets or queries the state of RS232 hard flagging. When hard flagging 
is enabled, the instrument sends data as long as CTS (Clear To Send) 
is asserted. When receiving data, the instrument asserts RTS 
(Request To Send) until the input buffer is almost full. When the 
instrument no longer asserts RTS, it continues to read incoming data 
until the input buffer is full and then reports an input overrun error. 
The instrument asserts DTR (Data Terminal Ready) at all times when 
the instrument power is on. 


Hard flagging and soft flagging cannot be on at the same time. 
However, hard and soft flagging can both be off at the same time. 
Turning hard flagging on turns soft flagging off. Turning soft 
flagging on turns hard flagging off. 


Group 
RS-232 


Syntax 

RS232:HARDFlagging { ON | OFF | <NRI> } 
RS232:HARDF lagging? 

Arguments 


<ON> or <NR1>+ 0 turns on hard flagging and turns off soft 
flagging. 


<OFF> or <NR1> = 0 turns off hard flagging (RTS always asserted). 
Examples 

RS232:HARDFLAGGING ON 

turns on hard flagging and turns off soft flagging. 


Related Commands 
RS232: BAUD, RS232: PARity, RS232:SOFTFLagging, RS232? 
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RS232:PARity 


Sets or queries the parity used for all RS-232-C data transfers. When 
parity is odd or even, the oscilloscope generates the selected parity 
on output and checks all input against the selected parity. When 
parity is none, the oscilloscope performs no input parity error checks 
and generates no output parity. 


When the parity (9th) bit does not match the parity type, the 
instrument reports a parity error. If another command is sent 
immediately after this command, without waiting for the parity to be 
programmed, the first few characters may be lost. 


Group 
RS-232 


Syntax 

RS232:PARity { EVEN | ODD | NONe } 
RS232:PARity? 

Arguments 

<EVEN> sets even parity. 

<QDD> sets odd parity. 

<NONe> sets no parity (no ninth bit transmitted). 
Examples 


RS232:PARITY EVEN 
sets even parity. 


Related Commands 


RS232: BAUD, RS232: HARDFLagging, RS232:SOFTFLagging, 
RS232? 
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RS232:SOFTFlagging 


Sets or queries the input and output soft flagging over the RS-232-C 
port. After receiving an XOFF (DC3), the instrument sends two or 
less characters. The oscilloscope begins transmitting data again when 
it receives an XON (DC1) character. 


The instrument sends an XOFF character when its input buffer is 
running out of space. After sending an XOFF character it can receive 
at least 20 more bytes. It sends XON when its input buffer has an 
acceptable number of free bytes. 


When soft flagging is enabled and binary data is transferred, data 
transmission will lock up if the data contains XOFF or XON 
characters. 


Hard flagging and soft flagging cannot be on at the same time. 
However, hard and soft flagging can both be off at the same time. 
Turning soft flagging on turns hard flagging off. Turning hard 
flagging on turns soft flagging off. 


Group 
RS-232 


Syntax 

RS232:SOFTFlagging { ON | OFF | <NRI> } 
RS232:SOFTFlagging? 

Arguments 


<ON> or <NR1>=+ 0 turns on soft flagging and turns off hard 
flagging. 


<OFF> or <NR1> = 0 turns off soft flagging. 
Examples 

RS232:SOFTFLAGGING ON 

turns on soft flagging and turns off hard flagging. 


Related Commands 
RS232: BAUD, RS232: HARDFLagging, RS232: PARity, RS232? 
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RS232:TRANsmit: TERMinator 


Sets or queries the end-of-line (EOL) terminator. When transmitting, 
the instrument appends the terminator to the end of each message. 
When receiving, the instrument accepts all four terminators, 
regardless of the currently selected terminator. When a combination 
of multiple characters is selected (CRLF or LFCR), the instrument 
interprets the first character as the terminator; it treats the second 
character as a null command. 


CR represents an ASCII carriage return character (OxOD) and LF 
represents an ASCII linefeed character (Ox0A). 


Group 
RS-232 


Syntax 

RS232:TRANsmit:TERMinator { CR | LF | CRLF | LFCr } 
RS232:TRANsmit: TERMinator? 

Arguments 

<CR> selects the carriage return character as the EOL terminator. 


<LF> selects the line feed character as the EOL terminator. 


<CRLf> selects the carriage return and line feed characters as the 
EOL terminator. 


<LFCr> selects the line feed and carriage return characters as the 
EOL terminator. 


Examples 
RS232: TRANsmit:TERMinator CR 
sets the carriage return as the EOL terminator. 


Related Commands 
RS232: HARDFLagging, RS232:SOFTFLagging, RS232? 
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*RST (No Query Form) 


2-134 


(Reset) Returns the oscilloscope to a known set of instrument 
settings, but does not purge any stored settings. This command 
executes a subset of the FACtory command. 


Group 
Status and Error 


Syntax 
*RST 


Sending the *RST command does the following: 


= Returns the instrument settings to the factory defaults (refer to 
Appendix B) 


m™ Sets the macro defined by *DDT to a zero-length field 
= Clears the pending operation flag and associated operations 
The *RST command does not alter the following items: 

m The state of the RS-232 or GPIB interface 

® Calibration data that affects device specifications 

m# The selected GPIB oscilloscope address 

= Stored settings or waveforms 

m The Output queue 

m The Service Request Enable Register settings 

m= ‘The Standard Event Status Enable Register settings 

m The Power-On Status Clear flag setting 

® Hard copy parameters 

™ Response Header Enable State 

@ Front panel LOCK state 


m Verbose State 


TDS 200-Series Programmer Manual 


Command Descriptions 


Examples 
None 


Related Commands 
FACtory, *PSC, *RCL, RECAII:SETUp, *S AV, SAVe:SETUp 


*SAV (No Query Form) 


(Save) Stores the state of the oscilloscope into a specified memory 
location. You can later use the *RCL command to restore the 
oscilloscope to this saved state. This is equivalent to selecting 
Save Setup in the Save/Recall Setup menu. 


Group 
Save and Recall 


Syntax 
*SAV <NR1> 


Arguments 


<NR1> is an integer value in the range from 1 to 5 and specifies a 
memory location. Any settings that have been stored previously at 
this location are overwritten. 


Examples 
*SAV 2 


saves the current settings in memory location 2. 


Related Commands 
FACtory, *RCL, RECAI:SETUp, SAVe:SETUp 
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SAVe:SETUp (No Query Form) 


Saves the current state of the oscilloscope into the specified memory 
location. This is equivalent to selecting Save Setup in the Save/Re- 
call Setup menu. 


Group 
Save and Recall 


Syntax 
SAVe:SETUp <NR1> 


Arguments 

<NR1> is an integer value in the range from 1 to 5 and specifies a 
memory location. Any settings that have been stored previously at 
this location are overwritten. 


Examples 
SAVE:SETUP 5 


saves the current front-panel setup to memory location 5. 


Related Commands 
RECAII:SETUp, *RCL, *SAV 
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SAVe:WAVEform (No Query Form) 


Stores a waveform in one of two reference memory locations. This 
command is equivalent to selecting the Save Waveform item in the 
Save/Recall Waveform menu. 


Group 
Save and Recall 


Syntax 
SAVe:WAVEform <wfm>, REF<x> 


Arguments 
<wfm> is CH1, CH2, or MATH. This is the waveform that will be saved. 


REF<x> is the location (A or B) where the waveform will be stored. 
Examples 
SAVE:WAVEFORM MATH, REFB 


saves the math waveform in stored waveform memory location 
REFB. 


Related Commands 
None 
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SELect? (Query Only) 


Returns the display status of all waveforms. 


Group 
Vertical 


Syntax 
SELect? 


Returns 
Waveform display status 


Examples 

SELECT? 

might return :SELECT:CH1 1;CH2 0;MATH 0;REFA 0; 
REFB 0 


Related Commands 
None 


SELect:<wfm> 


Controls the display of waveforms. This command is equivalent to 
turning a waveform on or off from the oscilloscope front panel. To 
define the math waveform, use the MATH:DEFINE command 
(page 2-110). 


Group 
Vertical 


Syntax 
SELect:<wfm> { OFF | ON | <NRI1> } 


SELect:<wfm>? 
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Arguments 
OFF or <NR1> = 0 turns off the display of the specified waveform. 


ON or <NR1> ~ 0 turns on the display of the specified waveform. 
<wfm> can be CH1, CH2, MATH, REFA, or REFB. 


Examples 
SELECT:CH2 ON 
displays channel 2. 


SELECT: REFA? 
returns either 0 or 1, indicating whether the REFA waveform is 
displayed. 


Related Commands 
None 


SET? (Query Only) 


Returns a string listing the oscilloscope settings except for the 
calibration values. You can use this string to return the oscilloscope 
to the state it was in when you sent SET?. This command is identical 
to the *LRN? command. 


Group 
Miscellaneous 


Syntax 
SET? 


NOTE. The SET? query always returns a string with command 
headers, regardless of the setting of the HEADer command. This is 
because the returned string is intended to be able to be sent back to 
the oscilloscope as a command string. The VERBose command can 
still be used to specify whether the returned headers should be 
abbreviated or full length. 
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Returns 
The oscilloscope settings except for the calibration values 


Examples 

She 

a partial return string may look like this: 

sACQUIRE:STOPAFTER RUNSTOP;STATE 1;MODE SAMPLE; NUMAVG 
16;:HEADER 1;:VERBOS 1;:DISPLAY: FORMAT YT;STYLE 
VECTORS; PERSISTENCE 500.0E-3;CONTRAST 50; :LOCK 

NONE; :HARDCOPY: FORMAT EPSON;PORT RS232;LAYOUT PORTRAIT; 


Related Commands 
HEADer, *LRN?, VERBos 


*SRE 


(Service Request Enable) sets and queries the bits in the Service 
Request Enable Register (SRER). For a complete discussion of the 
use of these registers, see page 3-1. 


Group 
Status and Error 


Syntax 
*SRE <NR1> 


*SRE? 


Arguments 

<NR1> is an integer value in the range from 0 to 255. The binary bits 
of the SRER are set according to this value. Using an out-of-range 
value causes an execution error. The power-on default for SRER is 0 
if *PSC is 1. If *PSC is 0, the SRER maintains its value through a 
power cycle. 
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Examples 
*SRE 48 
sets the bits in the SRER to 00110000 binary. 


*SRE? 
might return a value of 32, showing that the bits in the SRER have 
the binary value 00100000. 


Related Commands 
*CLS, DESE, *ESE, *ESR?, EVENT?, EVMSg?, FACtory, *PSC, 
*STB? 


*STB? (Query Only) 


(Read Status Byte) query returns the contents of the Status Byte 
Register (SBR) using the Master Summary Status (MSS) bit. For a 
complete discussion of the use of these registers, see page 3-1. 


Group 
Status and Error 


Syntax 
*STB? 


Returns 
<NR1> 


Examples 

*SIBL 

might return the value 96, showing that the SBR contains the binary 
value 01100000. 


Related Commands 
*CLS, DESE, *ESE, *ESR?, EVENT?, EVMSg?, FACtory, *SRE 
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*TRG (No Query Form) 


(Trigger) Executes commands that are defined by *DDT. 


Group 
Miscellaneous 


Syntax 
*TRG 


Arguments 
None 


Examples 

*TRG 

immediately executes all commands that have been defined by 
*DDT. 


Related Commands 
*DDT 


TRIGger 
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Forces a trigger event to occur. When used as a query, TRIGger? 
returns the current trigger parameters. 


Group 
Trigger 


Syntax 
TRIGger FORCe 


TRIGger? 


Arguments 


FORCe creates a trigger event. If TRIGger:STATE is REAdy, the 
acquisition will complete; otherwise this command will be ignored. 
This is equivalent to selecting FORCE TRIGGER on the front panel. 
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Examples 
TRIGGER FORCe 
forces a trigger event to occur. 


TRIGGER? 

might return : TRIGGER:MAIN:MODE AUTO;TYPE EDGE;LEVEL 
0.Q0E0;HOLDOFF: VALUE 5.0E-7;:TRIGGER:MAIN: EDGE: SOURCE 
CH1;COUPLING DC;SLOPE RISE; :TRIGGER:MAIN: VIDEO: SOURCE 
CH1;SYNC FIELD;POLARITY NORMAL 


Related Commands 
None 


TRIGger:MAIn 


Sets the oscilloscope main trigger level to 50% of the signal’s 
minimum and maximum value. Returns the current main trigger 
parameters when used as a query. 


Group 
Trigger 


Syntax 
TRIGger:MAIn SETLevel 


TRIGger:MAIn? 


Arguments 

SETLevel sets the main trigger level to half way between the MIN 
and MAX amplitudes of the trigger source input. This is equivalent 
to pressing the front-panel SET LEVEL TO 50% button. 


If the oscilloscope acquisition state is STOP and you send 
TRIGger:MAIn SETLevel, the oscilloscope ignores the command 
and generates event 221 (Settings conflict). 
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Examples 
TRIGGER:MAIN SETLEVEL 
sets the main trigger level mid way between MAX and MIN. 


Related Commands 
None 


TRiGger:MAIn:EDGE? (Query Only) 


Returns the trigger coupling, source, and slope settings for the main 
edge trigger. 


Group 
Trigger 


Syntax 
TRIGger:MAIn: EDGE? 


Returns 
Trigger coupling, source, and slope settings for the main edge trigger 


Examples 
TRIGGER:MAIN: EDGE? 
might return SOURCE CH1;COUPLING DC;SLOPE RISE 


Related Commands 
None 
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TRIGger:MAIn:EDGE:COUPling 


Sets or queries the type of coupling for the main edge trigger. This is 
equivalent to setting Coupling in the Trigger menu. 


Group 
Trigger 


Syntax 


TRIGger:MAIn:EDGE:COUPling { AC | DC | HFRej | LFRej | 
NOISErej } 


TRIGger:MAIn: EDGE:COUP1 ing? 


Arguments 
AC selects AC trigger coupling. 


DC selects DC coupling. 


HFRej coupling removes the high-frequency components of the DC 
signal. 
LFRej coupling removes the low-frequency components of the AC 
signal. 


NOISErej selects DC low sensitivity. It requires added signal 
amplitude for more stable, less false triggering. 


Examples 
TRIGGER:MAIN: EDGE: COUPLING DC 
sets the main edge trigger coupling to DC. 


Related Commands 
None 
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TRIGger:MAIn:EDGE:SLOpe 


Selects a rising or falling slope for the main edge trigger. This is 
equivalent to setting Slope in the Trigger menu. 


Group 
Trigger 


Syntax 
TRIGger:MAIn:EDGE:SLOpe { FALL | RISe } 


TRIGger:MAIn: EDGE: SLOpe? 


Arguments 
FALL specifies to trigger on the falling or negative edge of a signal. 


RISe specifies to trigger on the rising or positive edge of a signal. 


Examples 
TRIGGER:MAIN: EDGE:SLOPE RISE 
sets the main edge trigger to occur on the rising slope. 


Related Commands 
None 


TRIGger:MAIn:EDGE:SOUrce 


Sets or queries the source for the main edge trigger. This is 
equivalent to setting Source in the Trigger menu. 


Group 
Trigger 


Syntax 
TRIGger:MAIn:EDGE:SOUrce { CH<x> | EXT | EXT5 | LINE } 


TRIGger:MAIn: EDGE: SOUrce? 
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Arguments 
CH<x> specifies one of the input channels (1 or 2). 


EXT specifies the external input. 
EXT5 specifies the external input attenuated by a factor of 5. 


LINE specifies the line signal as a trigger source. 


Examples 


TRIGGER:MAIN:EDGE:SOURCE CH1 
specifies the channel 1 as the edge trigger source. 


TRIGGER:MAIN: EDGE: SOURCE? 
might return CH2 for the edge trigger source. 


Related Commands 
None 


TRIGger:MAIn:HOLdoff? (Query Only) 


Returns the main trigger holdoff value. 


Group 
Trigger 


Syntax 
TRIGger:MAIn:HOLdof f? 


Returns 
Main trigger holdoff value 


Examples 
TRIGGER :MAIN: HOLDOFF? 
might return : TRIGGER:MAIN: HOLDOFF: VALUE 5.0E-7. 


Related Commands 
None 
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TRIGger:MAIn:HOLdoff: VALue 


Sets or queries the oscilloscope main trigger holdoff value. 


Group 
Trigger 


Syntax 
TRIGger:MAIn:HOLdoff:VALue <NR3> 


TRIGger:MAIn:HOLdoff : VALue? 
Arguments 


<NR3> is the main trigger holdoff value, in the range of 500 ns 
to 10s. 


Examples 
TRIGGER:MAIN:HOLDOFF:VALUE 10 
sets the holdoff value to 10 s. 


Related Commands 
None 
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TRiGger:MAIn:LEVel 


Sets the oscilloscope main trigger level. This command is equivalent 
to adjusting the front-panel TRIGGER LEVEL knob. 


NOTE. When the edge trigger source is set to AC LINE, the 
oscilloscope ignores the set form of the command and generates 
event 221 (Settings conflict). 


When the edge trigger source is set to AC LINE, the query form of 
the command returns zero. 


Group 
Trigger 


Syntax 
TRIGger:MAIn:LEVel <NR3> 


TRIGger:MAIn:LEVel? 


Arguments 
NR3 the main trigger level, in volts. 


Examples 
TRIGGER:MAIN: LEVEL? 
might return 1.4, indicating that the main edge trigger is set to 1.4 V. 


Related Commands 
None 
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TRiGger:MAIn:MODe 


Sets or queries the trigger mode for the edge trigger type. 


Group 
Trigger 


Syntax 
TRIGger:MAIn:MODe { AUTO | NORMal } 


TRIGger:MAIn:MODe? 


Arguments 

AUTO generates a trigger if a trigger is not detected within a specific 
time period. AUTO also enables scan mode for sweep speeds of 

100 ms/div and slower. 


NORMa1 waits for a valid trigger event. 


Examples 
TRIGGER:MAIN:MODE AUTO 
specifies that a trigger event is automatically generated. 


Related Commands 
None 


TRIGger:MAIn:TYPe 


Sets or queries the type of oscilloscope trigger. This is equivalent to 
setting Type in the Trigger menu. 


Group 
Trigger 


Syntax 
TRIGger:MAIn:TYPe { EDGE | VIDeo } 


TRIGger:MAIn:TYPe? 
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Arguments 


EDGE is a normal trigger. A trigger event occurs when a signal passes 
through a specified voltage level in the specified direction and is 
controlled by the TRIGger:MAIn:EDGE commands. 


VIDeo specifies that a trigger occurs when a specified signal is found 
and is controlled by the TRIGger:MAIn: VIDeo commands. 


Examples 

TRIGGER:MAIN: TYPE? 

might return VIDEO indicating that the main trigger type is a video 
trigger. 


Related Commands 
None 


TRIGger:MAIn:VIDeo? (Query Only) 


Returns the main video trigger parameters. 


Group 
Trigger 


Syntax 
TRIGger:MAIn:VIDeo? 


Examples 

TRIGGER:MAIN: VIDEO? 

might return : TRIGGER:MAIN: VIDEO:SOURCE CH1;SYNC FIELD; 
POLARITY NORMAL. 


Related Commands 
None ; 
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TRIGger:MAIn:ViIDeo:POLarity 


Sets or queries the video trigger polarity. This is equivalent to 
selecting Polarity in the Trigger/Video menu. 


Group 
Trigger 


Syntax 
TRIGger:MAIn:VIDeo:POLarity { INVERTed | NORMA] } 
(TDS2CM) 


TRIGger:MAIn:VIDeo:POLarity { INVert | NORMA] } (TDS2MM) 
TRIGger:MAIn:VIDeo:POLarity? 


Arguments 


INVERTed (TDS2CM) or INVert (TDS2MM) specifies a positive sync 
pulse. 


NORMal specifies a negative sync pulse. 
Examples 


TRIGGER:MAIN: VIDEO:POLARITY NORMAL 
selects negative sync polarity for the video trigger. 


Related Commands 
None 


TRIGger:MAIn:VIDeo:SOUrce 
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Sets or queries the source for the main video trigger. This is 
equivalent to selecting Source in the Video trigger menu. 


Group 
Trigger 
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Syntax 
TRIGger:MAIn:VIDeo:SOUrce { CH<x> | EXT | EXT5 } 


TRIGger:MAIn: VIDeo:SOUrce? 


Arguments 
CH<x> specifies one of the input channels (CH1 or CH2). 


EXT specifies the external input. 


EXT5 specifies the external input, attenuated by a factor of 5. 


Examples 


TRIGGER:MAIN: VIDEO:SOURCE CH1 
selects channel 1 as the source for the main video trigger. 


Related Commands 
None 


TRIGger:MAIn:VIDeo:SYNc 


Sets or queries the source for the video trigger sync. This is 
equivalent to selecting Sync in the Trigger/Video menu. 


Group 
Trigger 


Syntax 
TRIGger:MAIn:VIDeo:SYNc { FIELD | LINE } 


TRIGger:MAIn: VIDeo:SYNc? 


Arguments 
FIELD specifies that triggering occur on the vertical sync pulse. 


LINE specifies that triggering occur on the horizontal sync pulse. 
Examples 


TRIGGER:MAIN: VIDEO:SYNc FIELD 
selects the vertical sync pulse for the main video trigger sync. 
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Related Commands 
None 


TRIGger:STATE? (Query Only) 
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Returns the current state of the triggering system. 


Group 
Trigger 


Syntax 
TRIGger: STATE? 


Returns 


REAdy indicates that all pretrigger information has been acquired and 
the oscilloscope is ready to accept a trigger. 


TRIGger indicates that the oscilloscope has seen a trigger and is 
acquiring the posttrigger information. 


AUTO indicates that the oscilloscope is in auto mode and acquires 
data even in the absence of a trigger. 


SAVE indicates that acquisition is stopped or that all channels are off. 


ARMed indicates that the oscilloscope is acquiring pretrigger 
information. All triggers are ignored when TRIGger:STATE is 
ARMed. 


SCAn indicates that the oscilloscope is in scan mode. 


Examples 

TRIGGER: STATE? 

might return READY, indicating that pretrigger data has been acquired 
and the oscilloscope is waiting for a trigger. 


Related Commands 
None 
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*TST? (Query Only) 


(Self-Test) Tests the GPIB interface and always returns a 0. 


Group 
Miscellaneous 


Syntax 
*TS Vt 


Returns 
0 


Examples 
None 


Related Commands 
None 


UNLock (No Query Form) 


Unlocks the front panel. This command is equivalent to LOCk 
NONe. 


NOTE. If the oscilloscope is in the Remote With Lockout State 
(RWLS), the UNLock command has no effect. For more information 
refer to ANSI-IEEE Std. 488. 1-1987, Standard Digital Interface for 
Programmable Instrumentation, section 2.8.3, on RL State descrip- 
tions. 


Group 
Miscellaneous 


Syntax 
UNLock ALL 
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Arguments 
ALL specifies all front-panel buttons. 


Examples 
UNLock ALL 
unlocks all front-panel buttons and knobs so they can be used. 


Related Commands 
LOCk 


VERBos 


Sets and queries the Verbose state that controls the length of 
keywords on query responses. Keywords can be both headers and 
arguments. This command does not affect IEEE Std 488 .2-1987 
Common Commands (those starting with an asterisk). 


Group 
Miscellaneous 


Syntax 
VERBos { OFF | ON | <NRI> } 


VERBos? 


Arguments 


ON or <NR1> ~ 0 sets the Verbose state true, which returns full-length 
keywords for applicable setting queries. 


OFF or <NR1> =0 sets the Verbose state false, which returns 
minimum-length keywords for applicable setting queries. 
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Examples 
VERBOS ON 
sets the Verbose state true. 


VERBOS? 
might return the value 1, showing that the Verbose state is true. 


Related Commands 
HEADer, *LRN?, SET? 


*WAI (No Query Form) 


*WAI (wait) prevents the oscilloscope from executing further 
commands or queries until all pending operations finish. This 
command lets you synchronize the operation of the oscilloscope with 
your application program. Synchronization methods are described on 
page 3-10. 


Group 
Status and Error 


Syntax 
*WAI 


Arguments 
None 


Examples 
None 


Related Commands 
BUSY?, *OPC 
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WAVFrm? (Query Only) 


Returns WFMPre? and CURVe? data for the waveform specified by 
the DATa:SOUrce command. This command is equivalent to sending 
WFMPre?; CURVe?. If the waveform specified by the 
DATa:SOUrce command is not displayed, the oscilloscope returns 
only the waveform transmission parameters (BYT Nr, BIT_Nr, 
ENCdg, BN Fmt, BYT Or, NR Pt). 


Group 
Waveform 


Syntax 
WAVF rm? 


Returns 
See WFMPre? and CURVe? commands. 


Examples 
None 


Related Commands 
CURVe?, DATa:SOUrce, WEMPre? 


WFMPre? (Query Only) 


Returns waveform transmission and formatting parameters for the 
waveform specified by the DATa:SOUrce command. If the waveform 
specified by the DATa:SOUrce command is not displayed, the 
oscilloscope returns only the waveform transmission parameters 
(BYT_Nr, BIT Nr, ENCdg, BN Fmt, BYT Or, NR Pt). 


Group 
Waveform 


Syntax 
WFMPre? 
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Returns 
The format of the response is: 


BYT_Nr <NR1>;BIT Nr <NRI>;ENCdg { ASC | BIN }; 

BN Fmt { RI | RP };BYT Or { LSB | MSB };NR Pt <NRI>; 
WFID <Qstring>;PT_FMT {ENV | Y};XINcr <NR3>; 

PT_Off <NRI>;XZERo <NR3>;XUNit<QString>;YMUIt <NR3>; 
YZEro <NR3>;YOFf <NR3>;YUNit <QString> 


Examples 
None 


Related Commands 
WAVFrm?, WFMPre:<wfm>? 


WFMPre:BIT_Nr 


Sets or queries the number of bits per waveform point for the 
waveform to be transferred. Changing the value of WFMPre:BIT_Nr 
also changes the values of WFMPRe:BYT_Nr and DATa:WIDth. 


Group 
Waveform 


Syntax 
WFMPre:BIT Nr <NR1> 


WFMPre:BIT Nr? 
Arguments 


<NR1> is either 8 or 16, and is equivalent to WFMPre:BYT_Nr * 8 
and DATa:WIDth * 8. 


Examples 
WFMPRE:BIT NR? 


might return 8, indicating that there are 8 bits per waveform point. 


Related Commands 
DATa:WIDth, WFMPre:BYT_Nr 
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WFMPre:BN_Fmt 


Sets or queries the format of binary data for the waveform to be 
transferred. Changing the value of WFMPre:BN_Fmt also changes 
the value of DATa:ENCdg. 


Group 
Waveform 


Syntax 

WFMPre:BN Fmt { RI | RP } 

WFMPre:BN_ Fmt? 

Arguments 

RI specifies signed integer data-point representation. 
RP specifies positive integer data-point representation. 
Examples 

WFMPRE:BN FMT RP 


specifies that the binary waveform data are positive integer 
data-points. 


WFMPRE:BN_ FMT? 
returns either RI or RP as the current waveform data format. 


Related Commands 
DATa:ENCdg, WFMPre:B YT_Or, WFMPre:ENCdg 
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WFMPre:BYT_Nr 


Sets or queries the data width for the waveform to be transferred. 
This command is equivalent to DATa:WIDth. Changing 
WFMPre:BYT_Nr also changes WFMPre:BIT_Nr and DATa:WIDth. 


Group 
Waveform 


Syntax 
WFMPre:BYT Nr <NR1> 
WFMPre:BYT Nr? 


Arguments 


<NR1> is an integer in the range of 1 to 2 that sets the number of 
bytes per point. 


Examples 
WFMPRE:BYT NR 2 
specifies that there are 2 bytes per waveform data point. 


Related Commands 
DATa:WIDth, WFMPre:BIT_Nr 


WFMPre:BYT_ Or 


Sets or queries which byte of binary waveform data is transmitted 
first during a waveform data transfer when DATa:WIDth or 
WFMPre:BYT_Nr is set to 2, or WFMPre:BIT_Nr is set to 16. 
Changing WFMPre:BYT_Or changes DATa:ENCdg. 


Group 
Waveform 


Syntax 
WFMPre:BYT Or { LSB | MSB } 


WFMPre:BYT Or? 
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_ Arguments 
LSB selects the least significant byte to be transmitted first. 


MSB selects the most significant byte to be transmitted first. 
Examples 
WFMPRE:BYT OR MSB 


specifies that the most significant byte in the waveform data is 
transferred first. 


WFMPRE:BYT OR? 
returns either MSB or LSB depending on which data byte is transferred 
first. 


Related Commands 
DATa:ENCdg, WFMPre:BN_Fmt, WFMPre:ENCdg 


WFMPre:ENCdg 


Sets or queries the type of encoding for waveform data transferred 
with the CURVe command. Changing WFMPre:ENCdg also changes 
DATa:ENCdg. 


Group 
Waveform 


Syntax 
WFMPre:ENCdg { ASC | BIN } 


WFMPre:ENCdg? 


Arguments 
ASC specifies ASCII curve data. 


BIN specifies binary curve data. 
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Examples 
WFMPRE:ENCDG ASC 
specifies that the waveform data is in ASCII format. 


WFMPRE: ENCDG? 
might return BIN, indicating that the waveform data is in binary 
format. 


Related Commands 
DATa:ENCdg, WFMPre:B YT_Or, WFMPre:BN_Fmt 


WFMPre:NR_Pt? (Query Only) 


Returns the number of points that are in the transmitted waveform 
record. The number of points is the absolute value of (DATa:STOP — 
DATA:STARt) +1. The set form of this command is ignored. 


Group 
Waveform 


Syntax 
WFMPre:NR_Pt? 


Arguments 
None 


Examples 

WFMPRE:NR Pt? 

returns <NR1>, which is the number of data points. If DATa:WIDth is 
2, then there are <NR1>*2 bytes in the curve. 


Related Commands 
DATa:ENCdg, WFMPre:BYT_Or, WFMPre:BN_Fmt 
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WFMPre:PT_Fmt 


The set form of this command sets the format (Y or ENV) of the 
reference waveform as specified by the DATa:DESTination 
command. 


The query form returns the format of the waveform specified by the 
DATa:SOUrce command, if that waveform is on or displayed. If the 
waveform is not displayed, the query form of this command 
generates an error and returns event code 2244. 


Group 
Waveform 


Syntax 
WFMPre:PT Fmt { ENV | Y } 


WFMPre:PT Fmt? 


Arguments 
Y specifies a normal waveform where one ASCII or binary data point 


is transmitted for each point in the waveform record. Only y values 
are explicitly transmitted. Absolute coordinates are given by: 

X, = XZEro + XINcr (n-PT_Off) 

Y, = YZEro + YMUIt (y, — YOFf) 


ENV specifies that the oscilloscope transmit the waveform as 
minimum and maximum point pairs. Peak detect waveforms use an 
ENV format. Only y values are explicitly transmitted. Absolute 
coordinates are given by: 


X, = XZEro + XINcr (n-PT_Off) 
Yin = YZEro + YMUIt Vn nin — YOFf) 
Yimax = YZEro + YMUIt (yn,,, — YOFf) 
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Examples 
WFMPRE:PT FMT Y 
sets the waveform data point format to Y. 


WFMPRE:PT_ FMT? 
returns either Y or ENV. 


Related Commands 
None 


WFMPre:PT_Off 


The set form of this command is ignored. The query form always 
returns a 0. This command is listed for compatibility with older 
Tektronix oscilloscopes. 


Group 
Waveform 


Syntax 
WFMPre:PT_ Off? 


Arguments 
Arguments are ignored. 


Related Commands 
HORizontal:POsition 
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WFMPre:WFld? (Query Only) 


Returns a descriptive string from the waveform specified in the 
DATa:SOUrce command, if that waveform is on or displayed. If that 
waveform is not on or displayed, the query fails and the oscilloscope 
generates an execution error with event code 2244 (waveform 
requested is not on). 


Group 
Waveform 


Syntax 
WFMPre:WFId? 


Arguments 
None. 


Examples 

WFMPRE:WFId? 

(YT waveform) :WFMPRE:WFID "CH1 DC COUPLING, 1.0E-1 
V/DIV, 5.0E-5 S/DIV, 2500 POINTS, SAMPLE MODE" 


(Non-FFT Math waveform) :WFMPRE:WFID "MATH, AC COUPLING, 
5.0E0 V/DIV, 5.0E-6 S/DIV, 2500 POINTS, PK DETECT MODE" 


(FFT waveform TDS2MM Only) WFMPRE:WFID "MATH, DC 
COUPLING, 1.0E1 DB/DIV, 5.0E3 HZ/DIV, 1024 POINTS, 
SAMPLE MODE" 


Related Commands 
WEMPre:<wfm>:WFId 
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WFMPre:XINer 


The set form of this command specifies the interval (seconds per 
point for non-FFT, Hertz per point for FFT) between samples of the 
reference waveform specified by the DATa:DESTination command. 
The oscilloscope uses this value to calculate the seconds/division or 
Hertz/division units shown in the status bar and cursor readouts when 
displaying a reference waveform. 


The query form returns the interval between samples of the 
waveform specified by the DATa:SOUrce command, if that 
waveform is on or displayed. If that waveform is not on or displayed, 
the query fails and the oscilloscope generates an execution error with 
event code 2244 (waveform requested is not on). 


Group 
Waveform 


Syntax 
WFMPre:XINcr <NR3> 


-WFMPre:XINcr? 


Arguments 
<NR3> is the sampling interval, in seconds or Hertz per point. 


Examples 
None 


Related Commands 
WFMpPre:<wfm>:XINcr 
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WFMPre:XUNit (TDS2CM Version) 


The set form of this command is ignored. 


The query form returns ”S”’. If the waveform specified by 
DATa:SOURCce is not displayed, the query generates event message 
2244. 


Group 
Waveform 


Syntax 
WFMPre: XUNit 


WFMPre:XUNit? 


Examples 
None 


Related Commands 
WFEMPre:<wfm>:XUNit 
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WFMPre:XUNit (TDS2MM Version) 


The set form of this command is only valid for reference waveforms. 
Setting a reference waveform to Hz causes the oscilloscope to 
display the reference waveform as an FFT waveform. 


The query form returns the horizontal units for the waveform 
specified by DATa:SOURCce (’S” for seconds, ”Hz” for Hertz). If the 
waveform specified by DATa:SOURCce is not displayed, the query 
generates event message 2244. 


Group 
Waveform 


Syntax 
WFMPre:XUNit <qstring> 


WFMPre: XUNit? 


Arguments 
egserinog>is s or Hz’. 


Examples 
None 


Related Commands 
WFEMPre:<wfm>:XUNit 
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WFMPre:XZEro 


The set form of this command specifies the position, in XUNits, of 
the first sample of the reference waveform specified by the 
DATa:DESTination command. 


The query form returns the position of the first sample of the 
waveform specified by the DATa:SOUrce command, if that 
waveform is on or displayed. 


If that waveform is not on or displayed, the query fails and the 
oscilloscope generates an execution error with event code 2244 
(waveform requested is not on). 


The oscilloscope sets WFMPre:XZEro to zero if the display mode 
was XY when you acquired the waveform. 


NOTE. The oscilloscope uses XZEro when calculating cursor 
readouts. 


Group 
Waveform 


Syntax 
WFMPre:XZEro <NR3> 


WFMPre:XZEro? 


Arguments 
<NR3> is the position, in XUNits, of the first sample in the waveform. 


Examples 
None 


Related Commands 
WFEMPre:<wfm>:XZEro 
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WFMPre: YMUIt 


The set form of this command sets the vertical scale factor of the 
reference waveform specified by the DATa:DESTination command, 
expressed in YUNits per digitizing level. 


The query form returns the vertical scale factor of the waveform 
specified by the DATa:SOUrce command, if that waveform is on or 
displayed. If that waveform is not on or displayed, the query fails 
and the oscilloscope generates an execution error with event code 
2244 (waveform requested is not on). 


Group 
Waveform 


Syntax 
WFMPre: YMUI1t <NR3> 


WFMPre: YMU1t? 


_ Arguments 
<NR3> is the vertical scale factor, in YUNits (usually volts) per 
sample value. 


An argument value of zero has special meaning. A zero indicates that 
the waveform has unknown vertical scaling. An example of unknown 
vertical scaling is a math waveform of CH1+CH2 where CH1 
vertical scaling is different from CH2 vertical scaling. In this case, 
WFMPre:Y UNit returns U. 


Examples 
None 


Related Commands 
WFEMPre:Y UNit? 
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WFMPre:YOFf 


YOFf is a value, expressed in digitizer levels, used to convert 
waveform record values to YUNit values using the following 
formula (where dl is digitizer levels): 


value_in_units = 
((curve_in_dl — YOFF_in_dl) * YMULT) + YZERO_in_units 


The set form of this command stores a value for the reference 
waveform specified by the DATa:DESTination command. This value 
does not affect how the oscilloscope displays the waveform, but does 
affect the cursor readouts. 


The query form returns the vertical position of the waveform 
specified by the DATa:SOUrce command, in digitizer levels, if that 
waveform is on or displayed. If that waveform is not on or displayed, 
the query fails and the oscilloscope generates an execution error with 
event code 2244 (waveform requested is not on). 


Group 
Waveform 


Syntax 
WFMPre:YOFf <NR3> 


WFMPre: YOFf? 


Arguments 
<NR3> is a value expressed in digitizing levels. 


Examples 
None 


Related Commands 
None 
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WFMPre:YUNit (TDS2CM Version) 


The set form of this command is ignored. Refer to the 
WFMPre: YMUIt command for equivalent functionality. 


NOTE. The WFMPre:YMUIt command determines the vertical units 


of the reference waveform specified by the DATa:DESTination 
command. Setting YMUIt to zero specifies unknown (U) units; any 
other value sets the vertical scale units to V (volts). 


The query form returns the vertical units of the waveform specified 
by the DATa:SOUrce command, if that waveform is on or displayed. 
If that waveform is not on or displayed, the query fails and the 
oscilloscope generates an execution error with event code 2244 
(waveform requested is not on). 


Group 
Waveform 


| Syntax 


WFMPre: YUNit? 


Returns 
"Volts" for volts or "U" for units (divisions). 


Examples 
None 


Related Commands 


WFMPre:YUNit (TDS2MM Only), WFMPre:<wfm>: YUNit, 
WFMPre: YMUIt 
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WFMPre:YUNit (TDS2MM Version) 


The set form of this command sets the vertical units for the reference 
waveform specified by DATa:DESTination. 


NOTE. It is possible to set a combination of WFMPre:XUNit and 
WFMPre:YUNit that is inconsistent (for example, seconds with dB or 
Hertz with volts). The oscilloscope will not warn you of this 
condition. The oscilloscope uses WFMPre:XUNit to determine if the 
waveform is a YT or an FFT. 


The query form returns the vertical units of the waveform specified 
by the DATa:SOUrce command, if that waveform is on or displayed. 
If that waveform is not on or displayed, the query fails and the 
oscilloscope generates an execution error with event code 2244 
(waveform requested is not on). 


Group 
Waveform 


Syntax 
WFMPre: YUNit <qstring> 


WFMPre: YUNit? 


Arguments 
<qstring> is’ Volts”, °U”, or dB”. 


Returns 
"Volts" for volts, "U" for units (divisions), or "dB" for decibels. 


Examples 
None 


Related Commands 
WFMPre: YUNit, WEMPre:<wfm>:YUNit, WFMPre: YMUIt 
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WFMPre:YZEro (TDS2CM Version) 


Y ZEro is a value, expressed in YUNits, used to convert waveform 
record values to YUNit values using the following formula (where dl 
is digitizer levels): 


value_in_units = 
((curve_in_dl — YOFF_in_dl) * YMULT) + YZERO_in_units 


The set form of this command is ignored. The query form of this 
command always returns ”0”. 


Group 
Waveform 


Syntax 
WFMPre: YZEro? 


Arguments 
Arguments are ignored 


Examples 
None 


Related Commands 
None 
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WFMPre:YZEro (TDS2MM Version) 
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YZEro is a value, expressed in YUNits, used to convert waveform 
record values to YUNit values using the following formula (where dl 


is digitizer levels): 


value_in_units = 


((curve_in_dl —- YOFF_in_dl) * YMULT) + YZERO_in_units 


The set form of this command sets a value used when calculating 


cursor readouts. 


Group 
Waveform 


Syntax 
WFMPre:YZEro <NR3> 


WFMPre: YZEro? 


Arguments 
<NR3> is a value, expressed in YUNits. 


Examples 
None 


Related Commands 
WFEMPre:<wfm>: Y ZEro 
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WFMPre—Additional Commands for Compatibility 


Table 2—23 lists additional WFMPre commands. The oscilloscope 
ignores the set form of these commands, and the query form 
generates event messages 100 and 420. The commands are included 
for compatibility purposes only. 


Table 2-23: Additional WFMPre commands 


Command Description 
WFMPre:XMU1t <NR3> Horizontal (X-axis) scale factor 
( 


WFMPre: XOFf Horizontal (X-axis) offset 
WFMPre:ZMU1t Z-axis scale factor 
WEMPre:ZOFf Z-axis offset 
WFMPre:ZUNit Z-axis units 
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WFMPre:ZZEror <NR3> Z-axis origin offset 
_WFMPre:<wfm>:NR_Pt | <NR1> Number of points in the curve 
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Command Descriptions 


WFMPre:<wfm>? (Query Only) 


Returns the waveform formatting data for the waveform specified by 
<wfm>, if that waveform is on or displayed. If that waveform is not 
on or displayed, the query fails and the oscilloscope generates event 
message 420 (Query unterminated) and 2244 (Waveform requested is 
not on). 


NOTE. When sending WFMPRE: <wfm>:mnemonic information to 
the oscilloscope, the value of <wfm> must be REFA or REFB. The 
oscilloscope ignores <wfm> for any value other than REFA or 
REFB. 


The WFMPre: <wfm>:mnemonic commands do not use the values set 
by the DATA:SOUrce or DATA: DESTINATION commands 


Group 
Waveform 


Syntax 
WFMPre:<item>? 
where <item> is REFA, REFB, CH1, CH2, or MATH. 


Returns 
The format of the response is: 


:WFMPre:<wfm>:WFID <Qstring>;PT FMT { ENV | Y }; 
XINcr <NR3>;PT Off <NR1>;XZEro <NR3>;XUNit <QString>; 
YMUI1t <NR3>;YZEro <NR3>;YOFf <NR3>;YUNit <QString> 


Examples 
None 


Related Commands 
WEMPre? 
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WEFMPre:<wfm>:PT_Fmt 


The set form of this command sets the waveform format (Y or ENV) 
of the reference waveform specified by <wfm>, if <wfm> is REFA 
or REFB. If <wfm> is not REFA or REFB, the set command is 
ignored. 


The query form returns the waveform format of the waveform 
specified by <wfm>, if that waveform is on or displayed. If that 
waveform is not on or displayed, the query fails and the oscilloscope 
generates an execution error with event code 2244 (waveform 
requested is not on). 


Group 
Waveform 


Syntax 
WFMPre:<wfm>:PT Fmt { ENV ala 


WFMPre:<wfm>:PT Fmt? 


Arguments 


Y specifies a normal waveform where one ASCII or binary data point 
is transmitted for each point in the waveform record.Only y values 
are explicitly transmitted. Absolute coordinates are given by: 


X, = XZEro + XINcr (n—PT_Off) 

Y, = YZEro + YMUIt (y, — YOF/) 

ENV specifies that the oscilloscope transmit the waveform as 
minimum and maximum point pairs. Peak detect waveforms use 


ENV format. Only y values are explicitly transmitted. Absolute 
coordinates are given by: 


» = XZEro + XINcr (n—PT_Off) 


Y,,,, = YZEro + YMUIt (yx, — YOF?) 
Yon. = YZEro + YMUIt (Ym — YOFP) 
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Examples 
WFMPRE:MATH:PT FMT? 
may return Y. 


Related Commands 
WEMPre:PT_FMT 


WFMPre:<wfm>:PT_Off 


The set form of this command is ignored. The query form always 
returns a 0. This command is listed for compatibility with older 
Tektronix oscilloscopes. 


Group 
Waveform 


Syntax 
WFMPre:<wfm>:PT Off? 


Arguments 
Arguments are ignored. 


Examples 
WFMPRE:CH1:PT OFF? 


returns 0 indicating the trigger offset within the waveform record. 


Related Commands 
WFMPre:PT_Off 
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WFMPre:<wfm>:WFld? (Query Only) 


Returns a descriptive string for the waveform specified by <wfm>, if 
that waveform is on or displayed. If that waveform is not on or 
displayed, the query fails and the oscilloscope generates an execution 
error with event code 2244 (waveform requested is not on). 


Group 
Waveform 


Syntax 
WFMPre:<wfm>:WFId? 


Examples 

WFMPRE:CH1:WFId? 

(YT waveform) :WFMPRE:WFID "CH1 DC COUPLING, 1.0E-1 
V/DIV, 5.0E-5 S/DIV, 2500 POINTS, SAMPLE MODE" 


(Non-FFT Math waveform) :WFMPRE:WFID "MATH, AC COUPLING, 
5.0E0 V/DIV, 5.0E-6 S/DIV, 2500 POINTS, PK DETECT MODE" 


(FFT waveform TDS2MM Only) WFMPRE:WFID "MATH, DC 
COUPLING, 1.0E1 DB/DIV, 5.0E3 HZ/DIV, 1024 POINTS, 
SAMPLE MODE" 


Related Commands 
WEMPre:WFId 
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WEFMPre:<wfm>:XINcr 
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The set form of this command specifies the interval (seconds per 
point for non-FFT, Hertz per point for FFT) between samples of the 
reference waveform specified by <wfm>, if <wfm> is REFA or 
REFB. If <wfm> is not REFA or REFB, the set command is ignored. 
The oscilloscope uses this value to calculate the seconds/division or 
Hertz/division units, shown in the status bar and cursor readouts, 
when displaying a reference waveform. 


The query form returns the interval between samples of the 
waveform specified by <wfm>, if that waveform is displayed. If that 
waveform is not displayed, the query fails and the oscilloscope 
generates an execution error with event code 2244 (waveform 
requested is not on). 


NOTE. For waveform records acquired in Peak Detect mode, even 
though there is a pair of samples for each conceptual time period, the 
XINcr ts such that (XINcr * recl) = the total time over which the data 
was collected. 


Group 
Waveform 


Syntax 
WFMPre:<wfm>:XINcr <NR3> 


WFMPre:<wfm>:XINcr? 


Arguments 
<NR3> is the sampling interval in XUNits. 


Examples 
WFMPre:CH1:XINcr? 
might return :WFMPRE:CH1:XINCR 2.0E-6 


Related Commands 
WEMPRE:XINcr 
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WFMPre:<wfm>:XUNit (TDS2CM Version) 


The set form of this command is ignored. 


The query form returns ’S”’. If the waveform specified by 
DATa:SOURCce is not displayed, the query generates event message 
2244. 


Group 
Waveform 


Syntax 
WFMPre: <wfm>: XUNi t? 


Examples 
WFMPRE:CH1:XUNIT? 


returns "Ss", indicating that the horizontal unit for channel 1 is 
seconds. 


Related Commands 
WFMPre:XUNit 
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WFMPre:<wfm>:XUNit (TDS2MM Version) 


The set form of this command is only valid for reference waveforms. 
Setting a reference waveform to Hz causes the oscilloscope to 
display the reference waveform as an FFT waveform. 


The query form returns the horizontal units for the waveform 
specified by DATa:SOURce (’S” for seconds, ”Hz” for Hertz). If the 
waveform specified by DATa:SOURCce is not displayed, the query 
generates event message 2244. 


Group 
Waveform 


Syntax 
WFMPre:<wfm>:XUNit <qstring> 


WFMPre:<wfm>:XUNit? 


Arguments 
<qstring=iss or’ Hz. 


Examples 
None 


Related Commands 
WEMPre:XUNit 
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WFMPre:<wfm>:XZEro 


The set form of this command specifies the position, in XUNits, of 
the first sample of the reference waveform specified by <wfm>, if 
<wfm> is REFA or REFB. If <wfm> is not REFA or REFB, the set 
command is ignored. 


The query form returns the position of the first sample of the 
waveform specified by the DATa:SOUrce command, if that 
waveform is on or displayed. 


If the waveform is not displayed, the query fails and the oscilloscope 
generates an execution error with event message 2244 (Waveform 
requested is not on’’). 


The oscilloscope sets WFMPre:<wfm>:XZEro to zero if the display 
mode was XY when you acquired the waveform. 


NOTE. The oscilloscope uses XZEro when calculating cursor readout 
values. 


Group 
Waveform 


Syntax 
WFMPre:<wfm>:XZEro <NR3> 


WFMPre:<wfm>:XZEro? 


Arguments 
<NR3> is the position of the first waveform sample, in XUNits. 


Returns 
The format of the query return is 
:WFMPRE:<wfm>:XZERO <NR3> 


Related Commands 
None 
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WFMPre:<wim>:YMUIt 


The set form of this command specifies the vertical scale factor, 
expressed in YUNits per digitizer level, of the reference waveform 
specified by <wfm>, if <wfm> is REFA or REFB. If <wfm> is not 
REFA or REFB, the set command is ignored. 


The query form returns the vertical scale factor of the waveform 
specified by <wfm>, if that waveform is on or displayed. If that 
waveform is not on or displayed, the query fails and the oscilloscope 
generates an execution error with event code 2244 (waveform 
requested is not on). 


Group 
Waveform 


Syntax 
WFMPre:<wfm>:YMU1t <NR3> 


WFMPre:<wfm>:YMU1t? 


Arguments 


<NR3> is the scale factor, in YUNits (usually volts) per digitizing 
level. 


An argument value of 0 (zero) has special meaning. A 0 indicates 
that the waveform has unknown vertical scaling. An example of 
unknown vertical scaling is a math waveform of CH1—CH2 where 
the vertical scaling of CH1 is different from CH2. In this case, 
WFMPre:<wfm>:Y UNit? returns ”’U” (unknown). 


Examples 
WFMPre:CH1:YMU1t? 
might return :WFMPRE:CH1:YMULT 4.0E-2 


Related Commands 
WFMPre: YMUIt, WEMPre:<wfm>: Y UNit 
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WFMPre:<wfm>:YOFf 


Y OFf is a value, expressed in digitizer levels, used to convert 
waveform record values to YUNit values using the following 
formula (where dl is digitizer levels): 


value_in_units = 
((curve_in_dl —- YOFF_in_dl) * YMULT) + YZERO_in_units 


The set form of this command stores a value for the reference 
waveform specified by <wfm>, if <wfm> is REFA or REFB. This 
value does not affect how the oscilloscope displays the waveform, 
but does affect cursor readouts. If <wfm> is not REFA or REFB, the 
set command is ignored. 


The query form returns the value for the waveform specified by 
<wfm>, if that waveform is displayed. If that waveform is not 
displayed, the query fails and the oscilloscope generates an execution 
error with event code 2244 (waveform requested is not on). 


Group 
Waveform 


Syntax 
WFMPre:<wfm>:YOFf <NR3> 


WFMPre: <wfm>: YOFf? 


Arguments 
<NR3> is a value expressed in digitizing levels. 


Examples 
WFMPre:CH1: YOFT? 
might return :WFMPRE:CH1:YOFF 2.4E1 


Related Commands 
WFMPre: YOFf 


TDS 200-Series Programmer Manual 2-187 


Command Descriptions 


WFMPre:<wfm>:YUNit (TDS2CM Version) 


The set form of this command is ignored. Refer to the 
WFMPre:<wfm>YMUIt command for equivalent functionality. 


NOTE. The WFMPre:YMUIt command determines the vertical units 
of the reference waveform specified by the DATa:DESTination 
command. SettingYMUIt to zero specifies unknown (U) units; any 
other value sets the vertical scale units to V (volts). 


The query form returns the vertical units of the waveform specified 
by <wim>, if that waveform is displayed. If that waveform is not 
displayed, the query fails and the oscilloscope generates an execution 
error with event code 2244 (waveform requested is not on). 


Group 
Waveform 


Syntax 
WFMPre:<wfm>: YUNit? 


Returns 
<Qstring> is” V” for volts or ’U” for units. 


Examples 

WFMPRE:CH2:YUNIT? 

might return "V", meaning that the units for the vertical component 
of the channel 2 waveform data are volts. 


Related Commands 
WFEMPre: YUNit, WFEMPre:<wfm>:YMUIt 
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WFMPre:<wfm>:YUNit (TDS2MM Version) 


The set form of this command sets the vertical units for the reference 
waveform specified by DATa:DESTination. 


NOTE. It is possible to set a combination of WFMPre: <wfm>:XUNit 
and WF MPre:<wfm>:YUNit that is inconsistent (for example, 
seconds with dB or Hertz with volts). The oscilloscope will not warn 
you of this condition. The oscilloscope uses WFMPre: <wfm>:XUNit 
to determine if the waveform is a YT or an FFT. 


The query form returns the vertical units of the waveform specified 
by the DATa:SOUrce command, if that waveform is on or displayed. 
If that waveform is not on or displayed, the query fails and the 
oscilloscope generates an execution error with event code 2244 
(waveform requested is not on). 


Group 
Waveform 


Syntax 
WFMPre:<wfm>:YUNit <qstring> 
WFMPre: <wfm>: YUNit? 


Arguments 
<qstring> is ’ Volts”, ’U”, or ’dB”. 


Returns 


"Volts" for volts, "U" for units (divisions), or "dB" for decibels. 
The "U" occurs when doing a CH1+CH2 math operation and the 
channels have different volts/div settings. 


Examples 
None 


Related Commands 
WEMPre:Y UNit, WFMPre:<wfm>: Y UNit, WFMPre: YMUIt 
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WFMPre:<wfm>:YZEro (TDS2CM Version) 


YZEro is a value, expressed in YUNits, used to convert waveform 
record values to unit values using the following formula (where dl is 
digitizer levels): 


value_in_units = 
((curve_in_dl — YOFF_in_dl) * YMULT) + YZERO _in_units 


The set form of this command is ignored. The query form of this 
command always returns 0”. 


Group 
Waveform 


Syntax 
WFMPre:<wfm>: YZEro? 


Arguments 
Arguments are ignored. 


Examples 
WFMPre:CH1:YZEro? 
returns :WFMPRE:CH1:YZERO 0.0E0 


Related Commands 
None 
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WFMPre:<wfm>:YZEro (TDS2MM Version) 


Y ZEro is a value, expressed in YUNits, used to convert waveform 
record values to unit values using the following formula (where dl is 
digitizer levels): 


value_in_units = 
((curve_in_dl — YOFF_in_dl) * YMULT) + YZERO_in_units 


The set form of this command sets a value used when calculating 
cursor readouts. 


Group 
Waveform 


Syntax 
WFMPre:<wfm>:YZEro <NR3> 


WFMPre:<wfm>:YZEro? 


Arguments 
NR3 is a value, expressed in YUNits. 


Examples 
None 


Related Commands 
WFEMPre: Y ZEro 
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The oscilloscope provides a status and event reporting system for the 
GPIB and RS-232 interfaces. This system informs you of certain 
significant events that occur within the oscilloscope. 


The oscilloscope status reporting system consists of five 8-bit 
registers and two queues. This section describes these registers and 
components, and explains how the event handling system operates. 


Registers 


The registers in the event reporting system fall into two functional 
groups: 


m The Standard Event Status Register (SESR) and the Status Byte 
Register (SBR) contain information about the status of the 
oscilloscope. These registers are the Status Registers. 


® The Device Event Status Enable Register (DESER), the Event 
Status Enable Register (ESER), and the Service Request Enable 
Register (SRER) determine whether selected types of events are 
reported to the Status Registers and the Event Queue. These three 
registers are the Enable Registers. 


Status Registers 


The Standard Event Status Register (SESR) and the Status Byte 
Register (SBR) record certain types of events that may occur while 
the oscilloscope is in use. IEEE Std 488.2-1987 defines these 
registers. 


Each bit in a Status Register records a particular type of event, such 
as an execution error or service request. When an event of a given 
type occurs, the oscilloscope sets the bit that represents that type of 
event to a value of one. (You can disable bits so that they ignore 
events and remain at zero. See the Enable Registers section on 
page 3-4.) Reading the status registers tells you what types of 
events have occurred. 
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The Standard Event Status Register (SESR). The SESR, shown in 

Figure 3-1, records eight types of events that can occur within the 
oscilloscope. Use *ESR? to read the SESR register. Reading the 
register clears the bits of the register so that the register can 
accumulate information about new events. Table 3-1 shows SESR bit 


functions. 


7 6 5 4 3 2 1 0 
PON | URQ | CME | EXE | DDE | QYE | RQC | OPC 


Figure 3-1: The Standard Event Status Register (SESR) 


Table 3-1: SESR Bit Functions 


0 (LSB) 


Function 
PON (Power On). Shows that the oscilloscope was powered on. 


URQ (User Request). Not used. 


CME (Command Error). Shows that an error occurred while the 
oscilloscope was parsing a command or query. Command error 
messages are listed in Table 3-4 on page 3-17. 


EXE (Execution Error). Shows that an error occurred while the 
oscilloscope was executing a command or query. Execution error 
messages are listed in Table 3-5 on page 3-18. 


DDE (Device Error). Shows that a device error occurred. Device 
error messages are listed in Table 3-6 on page 3-21. 


QYE (Query Error). Shows that either an attempt was made to 
read the Output Queue when no data was present or pending, or 
that data in the Output Queue was lost. 


RQC (Request Control). Not used. 


OPC (Operation Complete). Shows that the operation is complete. 
This bit is set when all pending operations complete following a 
*OPC command. 
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The Status Byte Register (SBR). The SBR, shown in Figure 3-2, records 
whether output is available in the Output Queue, whether the 
oscilloscope requests service, and whether the SESR has recorded 
any events. 


Use a Serial Poll (GPIB only) or *STB? to read the contents of the 
SBR. The bits in the SBR are set and cleared depending on the 
contents of the SESR, the Event Status Enable Register (ESER), and 
the Output Queue. When you use a Serial Poll to obtain the SBR, bit 
6 is the RQS bit. When you use the *STB? query to obtain the SBR, 
bit 6 is the MSS bit. Reading the SBR does not clear the bits. 

Table 3—2 shows the SBR bit functions. 


Figure 3-2: The Status Byte Register (SBR) 


Table 3-2: SBR Bit Functions 


Bit Function 
7 (MSB) Not used. 


6 RQS (Request Service), obtained from a serial poll. Shows that 
the oscilloscope requests service from the GPIB controller. 

6 MSS (Master Status Summary), obtained from *STB?. 
Summarizes the ESB and MAV bits in the SBR. 

S ESB (Event Status Bit). Shows that status is enabled and present 
in the SESR. 

4 MAV (Message Available). Shows that output is available in the 
Output Queue. 

3-0 Not used. 
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Enable Registers 


The DESER, ESER, and SRER allow you to select which events are 
reported to the Status Registers and the Event Queue. Each Enable 
Register acts as a filter to a Status Register (the DESER also acts as a 
filter to the Event Queue) and can prevent information from being 
recorded in the register or queue. 


Each bit in an Enable Register corresponds to a bit in the Status 
Register it controls. In order for an event to be reported to its bit in 
the Status Register, the corresponding bit in the Enable Register must 
be set to one. If the bit in the Enable Register is set to zero, the event 
is not recorded. 


The bits in the Enable Registers are set using various commands. 
The Enable Registers and the commands used to set them are 
described below. 


The Device Event Status Enable Register (DESER). The DESER, shown 
in Figure 3-3, controls which types of events are reported to the 
SESR and the Event Queue. The bits in the DESER correspond to 
those in the SESR, as described earlier. 


Use the DESE command to enable and disable the bits in the 
DESER. Use the DESE? query to read the DESER. 


r 6 5 4 3 2 1 0 
PON | URQ | CME | EXE | DDE | QYE | RQC | OPC 


Figure 3-3: The Device Event Status Enable Register (DESER) 


3-4 TDS 200-Series Programmer Manual 


Status and Events 


The Event Status Enable Register (ESER). The ESER, shown in 
Figure 3-4, controls which types of events are summarized by the 
Event Status Bit (ESB) in the SBR. 


Use the *ESE command to set the bits in the ESER, and use the 
*ESE? query to read it. 


7 6 5 4 3 2 1 0 
PON | URQ | CME | EXE | DDE | QYE | RQC | OPC 


Figure 3-4: The Event Status Enable Register (ESER) 


The Service Request Enable Register (SRER). The SRER, shown in 
Figure 3-5, controls which bits in the SBR generate a Service 
REquest (GPIB only) and are summarized by the Master Status 
Summary (MSS) bit. 


Use the *SRE command to set the SRER. Use the *SRE? query to 
read it. The RQS bit remains set to one until either the Status Byte 
Register is read by a Serial Poll (GPIB only) or the MSS bit changes 
back to a zero. 


7 2) 4 3 2 1 
_ ESB |MAV; — | — | — 


Figure 3-5: The Service Request Enable Register (SRER) 
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The Enable Registers and the *PSC Command 


The *PSC command controls the contents of the Enable Registers at 
power on. Sending *PSC 1 sets the Enable Registers at power on as 
follows: 


# DESER 255 (equivalent to a DESe 255 command) 
= ESER 0 (equivalent to an *ESE 0 command) 
® SRER 0 (equivalent to an *SRE 0 command) 


Sending *PSC 0 lets the Enable Registers maintain their values in 
nonvolatile memory through a power cycle. 


NOTE. To enable the PON (Power On) event to generate a Service 
Request (GPIB only), send *PSC 0, use the DESe and *ESE 
commands to enable PON in the DESER and ESER, and use the 
*SRE command to enable bit 5 in the SRER. Subsequent power-on 
cycles will generate a Service Request (GPIB only). 


Queues 


The oscilloscope status and event reporting system contains two 
queues: the Output Queue and the Event Queue. 


The Output Queue 


The Output Queue stores query responses waiting to be output. The 
oscilloscope empties the Output Queue each time it receives a new 
command or query message. This means you must read any query 
response before you send the next command or query, or you will 
lose responses to earlier queries. Also, an error may result. 
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NOTE. When a controller sends a query, an <EOM>, and a second 
query, the digitizing oscilloscope normally clears the first response 
and outputs the second while reporting a Query Error (QYE bit in the 
ESER) to indicate the lost response. A fast controller, however, may 
receive a part or all the first response as well. To avoid this situation, 
the controller should always read the response immediately after 
sending any terminated query message or send a DCL (Device Clear) 
before sending the second query. 


The Event Queue 


The Event Queue stores detailed information on up to 20 events. If 
more than 20 events stack up in the Event Queue, the 20th event is 
replaced by event code 350, “Too many events.” 


Read the Event Queue with EVENT? (which returns only the event 
number), with EVMsg? (which returns the event number and a text 
description of the event), or with ALLEV? (which returns all the 
event numbers along with a description of the event). Reading an 
event removes it from the queue. 


Before reading an event from the Event Queue, you must use *ESR? 
to read the summary of the event from the SESR. This makes the 
events summarized by *ESR? available to EVENT? and EVMSG?, 
and empties the SESR. 


Reading the SESR erases any events that were summarized by 
previous *ESR? reads but not read from the Event Queue. Events 
that follow an *ESR? read are put in the Event Queue, but are not 
available until *ESR? is used again.. 
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Event Handling Sequence 


Figure 3-6 shows how to use the status and event handling system. 
In the explanation that follows, numbers in parentheses refer to 
numbers in Figure 3-6. 


When an event occurs, a signal is sent to the DESER (1). If that type 
of event is enabled in the DESER (that is, if the bit for that event 
type is set to 1), the appropriate bit in the SESR is set to one and the 
event is recorded in the Event Queue (2). If the corresponding bit in 
the ESER is also enabled (3), then the ESB bit in the SBR is set to 
one (4). 


When output is sent to the Output Queue, the MAV bit in the SBR is 
set to one (5). 


When a bit in the SBR is set to one and the corresponding bit in the 
SRER is enabled (6), the MSS bit in the SBR is set to one and a 
service request (GPIB only) is generated (7). 
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Device Event Status Enable Register 
(DESER) 


6 S 4 3 2 1 0 
URQ | CME | EXE | DDE | QYE | RQC | OPC 


Read using DESE? PON 


Write using DESE 


Standard Event Status Register 
(SESR) 
Read using “ESR? 
Cannot be written 


Event Status Enable Register 


(ESER) 6 5 4 3 2 1 0 
Read using *ESE? PON | URQ | CME | EXE | DDE | QYE | RQC | OPC 
Write using *ESE 
Status Byte Register 
(SBR) 
Read using “STB? 


Cannot be written 


Service Request Enable Register 
(SRER) 


Read using *SRE? 
Write using “SRE 


Figure 3-6: Status and Event Handling Process 
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Synchronization Methods 


Although most commands are completed almost immediately after 
being received by the oscilloscope, some commands start a process 
that requires more time. For example, once a HARDCOPY START 
command is executed, it may be a few seconds before the hardcopy 
operation is complete. Rather than remain idle while the operation is 
in process, the oscilloscope continues processing other commands. 
This means that some operations are not completed in the order that 
they were sent. 


There may be times when the result of an operation is dependent on 
the result of an earlier one, and you must be assured that the first 
operation has completed before processing the next one. The status 
and event reporting system provides ways to do this. 


For example, a typical application would be to acquire a single-se- 
quence waveform, and then take a measurement on the acquired 
waveform. You could use the following command sequence: 


/** Set up single-sequence acquisition **/ 

SELECT:CH1 ON 

ACQUIRE:MODE SAMPLE 

ACQUIRE: STOPAFTER SEQUENCE 

/** Acquire waveform data **/ 

ACQUIRE: STATE ON 

/** Set up the measurement 2 
MEASUREMENT: IMMED: TYPE PK2PK 
MEASUREMENT : IMMED: SOURCE CH1 

/** Take peak-to-peak measurement on acquired data **/ 


MEASUREMENT : IMMED: VALUE? 


The acquisition of the waveform requires extended processing time 
and may not complete before the amplitude measurement is taken. 
(See Figure 3-7.) This will result in an incorrect peak-to-peak value. 
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ACQUIRE:STATE ON “a 


ACQUIRE:STATE ON 


E Acquiring Waveform Data | 


| MEASUREMENT : IMMED: VALUE? | 


Processing Time 


Figure 3-7: Command Processing Without Using Synchronization 


The acquisition of the waveform must be completed before the 
measurement can be taken on the acquired data. This is achieved by 
synchronizing the program so that the measurement command is not 
processed by the oscilloscope until the acquisition is complete. 
Figure 3-8 shows the desired processing sequence. 


o Acquiring Waveform Data | 


| MEASUREMENT : IMMED : VALUE? | 


Processing Time 
Figure 3-8: Processing Sequence With Synchronization 


Four commands can be used to synchronize the operation of the 
oscilloscope with your application program: *WAI, BUSY?, *OPC, 
and *OPC?. 


Using the *WAl Command 


You can force commands to execute sequentially by using the *WAI 
command. This command forces completion of the previous 
commands before processing new ones. 
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The same command sequence using the *WAI command for 
synchronization follows: 


/* Set up single-sequence acquisition */ 
SELECT:CH1 ON 

ACQUIRE:MODE SAMPLE 

ACQUIRE: STOPAFTER SEQUENCE 

/* Acquire waveform data */ 
ACQUIRE:STATE ON 

/* Set up the measurement parameters */ 
MEASUREMENT: IMMED: TYPE PK2PK 
MEASUREMENT: IMMED: SOURCE CH1 


/* Wait until the acquisition is complete before taking the 
measurement */ 


*WAI 
/* Take peak-to-peak measurement on acquired data */ 


MEASUREMENT : IMMED: VALUE? 


> 


Though *WAT is one of the easiest ways to achieve synchronization 
itis also the most costly. The processing time of the oscilloscope is 

slowed, since it is processing a single command at a time. This time 
could be spent doing other tasks. 


The controller can continue to write commands to the input buffer, 
but the commands are not processed by the oscilloscope until all 
operations in process are complete. If the input buffer becomes full, 
the controller will be unable to write any more commands to the 
buffer and will result in a time out. 
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Using the BUSY Query 


BUSY? allows you to find out whether the oscilloscope is busy 
processing a command that has an extended processing time, such as 
single-sequence acquisition. 


The same command sequence using BUSY? for synchronization 
follows: 


/* Set up single-sequence acquisition */ 
SELECT:CH1 ON 

ACQUIRE:MODE SAMPLE 

ACQUIRE: STOPAFTER SEQUENCE 

/* Acquire waveform data */ 
ACQUIRE:STATE ON 

/* Set up the measurement parameters */ 
MEASUREMENT: IMMED: TYPE PK2PK 
MEASUREMENT: IMMED:SOURCE CH1 


/* Wait until the acquisition is complete before taking the 
measurement */ 


While BUSY? keep looping 
/* Take peak-to-peak measurement on acquired data */ 
MEASUREMENT : IMMED: VALUE? 


This sequence lets you create your own wait loop rather than using 
the *WAI command. An advantage to using BUSY? is that you 
eliminate the possibility of a time out caused by writing too many 
commands to the input buffer. The controller is still tied up, though, 
and the repeated BUSY? results in more bus traffic. 
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Using the *OPC Command 


If the corresponding status registers are enabled, the *OPC command 
sets the OPC bit in the Standard Event Status Register (SESR) when 
an operation is complete. You can use this command in conjunction 
with either a serial poll or service request handler to achieve 
synchronization. 


*OPC? places a 1 in the Output Queue once an operation is 
complete. 


The same command sequence using *OPC? for synchronization 
follows: 


/* Set up single-sequence acquisition */ 
SELECT:CH1 ON 

ACQUIRE:MODE SAMPLE 

ACQUIRE: STOPAFTER SEQUENCE 

/* Acquire waveform data */ 

ACQUIRE: STATE ON 

/* Set up the measurement parameters */ 
MEASUREMENT : IMMED: TYPE PK2PK 
MEASUREMENT : IMMED: SOURCE CH1 


/* Wait until the acquisition is complete before taking the 
measurement */ 


*OPC? 

Wait for read from Output Queue. 

/* Take peak-to-peak measurement on acquired data */ 
MEASUREMENT : IMMED: VALUE? 


Using *OPC? synchronization is the simplest approach. It requires no 
status handling or loops. However, you must set the controller time 
out for longer than the acquisition operation. 
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Serial Poll Method (GPIB Only). Enable the OPC bit in the Device 
Event Status Enable Register (DESER) and the Event Status Enable 
Register (ESER) using the DESE and *ESE commands. When the 
operation is complete, the OPC bit in the Standard Event Status 
Register (SESR) is enabled, and the Event Status Bit (ESB) in the 
Status Byte Register is enabled. 


The same command sequence using the *OPC command for 
synchronization with serial polling looks like this: 


/* Set up single-sequence acquisition */ 


SELECT:CH1 ON 
ACQUIRE:MODE SAMPLE 
ACQUIRE: STOPAFTER SEQUENCE 


/* Enable the status registers */ 


DESE 1 
SES Eaol 
eORE,.O 


/* Acquire waveform data */ 
ACQUIRE:STATE ON 
/* Set up the measurement parameters */ 


MEASUREMENT: IMMED: TYPE PK2PK 
MEASUREMENT: IMMED:SOURCE CH1 


/* Wait until the acquisition is complete before taking the 
measurement */ 


*OPC 
While serial poll = 0, keep looping 


/* Take peak-to-peak measurement on acquired data */ 
MEASUREMENT: IMMED: VALUE? 


This technique requires less bus traffic than did looping on 
BUSY?. 
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Service Request Method (GPIB Only). Enable the OPC bit in the 
Device Event Status Enable Register (DESER) and the Event Status 
Enable Register (ESER) using the DESE and *ESE commands. Also, 
enable service requests by setting the ESB bit in the Service Request 
Enable Register (SRER) using the *SRE command. When the 
Operation is complete, a Service Request is generated. 


The same command sequence using the *OPC command for 
synchronization looks like this: 


/* Set up single-sequence acquisition */ 


SELECT:CH1 ON 
ACQUIRE:MODE SAMPLE 
ACQUIRE: STOPAFTER SEQUENCE 


/* Enable the status registers */ 


DESt 
SESE 
*SRE Sac 


/* Acquire waveform data */ 
ACQUIRE: STATE ON 
/* Set up the measurement parameters */ 


MEASUREMENT: IMMED: TYPE PK2PK 
MEASUREMENT: IMMED: SOURCE CH1 


/* Wait until the acquisition is complete before taking the 
measurement */ 


“OPG 


Program can now do different tasks such as talk to other 
devices. The SRQ, when it comes, interrupts those tasks and 
returns control to this task. 


/* Take peak-to-peak measurement on acquired data */ 
MEASUREMENT : IMMED: VALUE? 


This technique is more efficient but requires more sophisticated 
programming. 
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Messages 


Tables 3—3 through 3-9 list all the programming interface messages 
the oscilloscope generates in response to commands and queries. 


Each message is the result of an event. Each type of event sets a 
specific bit in the SESR and is controlled by the equivalent bit in 
the DESER. Thus, each message is associated with a specific SESR 
bit. In the message tables that follow, the associated SESR bit is 
specified in the table title, with exceptions noted with the error 
message text. 


Table 3—3 shows the messages when the system has no events or 
status to report. These have no associated SESR bit. 


Table 3-3: No Event Messages 


Message 


No events to report : queue empty 


No events to report : new events pending “ESR? 


Table 3-4 shows the error messages generated by improper 
command syntax. Check that the command is properly formed and 
that it follows the rules in the Command Syntax section starting on 
page 2-1. 


Table 3-4: Command Error Messages.- CME Bit 5 


Code Message 

100 Command error 

102 Syntax error 

103 Invalid separator 

104 Data type error 

105 GET not allowed 

108 Parameter not allowed 
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Table 3-4: Command Error Messages - CME Bit 5 (Cont.) 


Code 
110 
111 
112 
113 
161 


Message 


Command header error 


Header separator error 


Program mnemonic too long 


Undefined header 


Invalid block data (indefinite length blocks are not allowed over the 


RS-232) 


Table 3-5 lists the errors that are detected during execution of a 
command. In these error messages, you should read “macro” as 


maltases 


Table 3-5: Execution Error Messages - EXE Bit 4 


Code 
200 


201 
210 
211 
212 
220 
221 
222 
223 
224 
230 
240 
241 


Message 
Execution error 
Invalid while in local 
Trigger error 
Trigger ignored 
Arm ignored 
Parameter error 


Settings conflict 


Data out of range 

Too much data 

Illegal parameter value 
Data corrupt or stale 
Hardware error 


Hardware missing 
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Table 3-5: Execution Error Messages - EXE Bit 4 (Cont.) 


Code 
242 
243 
260 
261 
2200 
2201 
2202 
2203 
2204 
2205 
2206 
2207 
2208 
2209 
2210 
221 
2212 
2213 
2214 
2215 
2216 
2217 
2218 
2219 
2220 


Message 
Hardware configuration error 


Hardware I/O device error 


Expression error 

Math error in expression 

Measurement error, Measurement system error 
Measurement error, Zero period 

Measurement error, No period found 

Measurement error, No period, second waveform 
Measurement error, Low signal amplitude 
Measurement error, Low amplitude, second waveform 
Measurement error, Invalid gate 

Measurement error, Measurement overflow 
Measurement error, Waveform does not cross Mid Ref 


Measurement error, No second Mid Ref crossing 


Measurement error, No Mid Ref crossing, second waveform 
Measurement error, No backwards Mid Ref crossing 
Measurement error, No negative crossing 

Measurement error, No positive crossing 

Measurement error, No crossing 

Measurement error, No crossing, second waveform 
Measurement error, No crossing, target waveform 


Measurement error, Constant waveform 


Measurement error, Unused 
Measurement error, No valid edge: No arm sample 


Measurement error, No valid edge: No arm cross 
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Table 3-5: Execution Error Messages - EXE Bit 4 (Cont.) 


Code Message 

2221 Measurement error, No valid edge: No trigger cross 
2222 Measurement error, No valid edge: No second cross 
2223 Measurement error, waveform mismatch 
2224 Measurement error, WAIT calculating 

2225 Measurement error, No waveform to measure 
2226 Null Waveform 

2227 Positive and Negative Clipping 

2228 Measurement error, Positive Clipping 

2229 Measurement error, Negative Clipping 

2230 Measurement error, High Ref < Low Ref 
2235 Math error, Invalid math description 

2241 Waveform request is invalid 

2242 Data start and stop > record length 

2243 Waveform requested is not a data source 
2244 Waveform requested is not turned on 

2245 Saveref error, Selected channel is turned off 
2246 Saveref error, Selected channel data invalid 
2248 Saveref error, Source reference data invalid 
2260 Calibration error 

2301 Cursor error, Off screen 

2302 Cursor error, Cursors are off 

2303 Cursor error, Cursor source waveform is off 
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Table 3-6 lists the device errors that can occur during oscilloscope 
operation. These errors may indicate that the oscilloscope needs 


repair. 


Table 3-6: Device Error Messages - DDE Bit 3 


Code 
300 


310 
311 
313 
314 
315 
350 
361 
362: 
363 


Message 
Device-specific error 


System error 


Memory error 

Calibration memory lost 

Save/recall memory lost 

Configuration memory lost 

Queue overflow (does not set DDE bit) 

Parity error in program message (check parity) 
Framing error in program message (check baud rate) 


Input buffer overrun (check flagging) 


Table 3-7 lists the system event messages. These messages are 
generated whenever certain system conditions occur. 


Table 3-7: System Event Messages 


Code 
400 


401 
402 
403 
404 
405 


Message 
Query event 


Power on (PON bit 7 set) 
Operation complete (OPC bit 0 set) 
User request (URQ bit 6 set) 
Power fail (DDE bit 3 set) 


Request control 
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Table 3-7: System Event Messages (Cont.) 


Message 
Query INTERRUPTED (QYE bit 2 set) 
Query UNTERMINATED (QYE bit 2 set) 
Query DEADLOCKED (QYE bit 2 set) 


Query UNTERMINATED after indefinite response (QYE bit 2 set), 
normally caused by using a query that returns arbitrary data in a 
concatenated command 


410 
420 


Table 3-8 lists warning messages that do not interrupt the flow of 
command execution. These notify you that you may get unexpected 
results. 


Table 3-8: Execution Warning Messages - EXE Bit 4 


Code Message 

500 Execution warning 

510 String data too long, truncated 

525 Parameter underrange 

526 Parameter overrange 

527 Parameter rounded 

528 Parameter out of range 

530 Data stop > stop, Values swapped internally 
531 Data stop > record length, Curve truncated 
532 Curve data too long, Curve truncated 

540 Measurement warning 

541 Measurement warning, Low signal amplitude 
542 Measurement warning, Unstable histogram 
543 Measurement warning, Low resolution 
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Table 3-8: Execution Warning Messages - EXE Bit 4 (Cont.) 


Code Message 

544 Measurement warning, Uncertain edge 

545 Measurement warning, Invalid in minmax 

546 Measurement warning, Need 3 edges 

547 Measurement warning, Clipping positive/negative 
548 Measurement warning, Clipping positive 

549 Measurement warning, Clipping negative 


Table 3-9 lists internal errors that indicate an internal fault in the 
oscilloscope. 


Table 3-9: Internal Warning Messages 


Message 
Internal warning 
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Continued on next page 
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Appendix A: ASCII Code Chart 


DEL 
(RUBOUT) 
7 427 


octal | 95 
KEY NK ASCII character 
hex 115 21 decimal 
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The following listing is the instrument response to the concatenated 
command FACTORY ;SET?. This response describes the factory default 
setup in detail. The SET? query response includes some additional 
items not changed by the FACTory command. 


Items enclosed in < > brackets are return values associated with the 
TDS2MM module. 


:HEADER 1; 


:DATA: ENCDG RIBINARY;DESTINATION REFA;SOURCE CH1; 
START 1;STOP 2500;WIDTH 1; 


:DISPLAY: FORMAT YT;STYLE VECTORS;PERSISTENCE 0; 
CONTRAST 50; 


ACQUIRE:MODE SAMPLE;NUMAVG 16;STATE 1;STOPAFTER 
RUNSTOP; 


:CH1:PROBE 10;SCALE 1.0E0;POSITION 0.050; 
COUPLING DC;BANDWIDTH OFF; <INVERT OFF;> 


:CH2:PROBE 10;SCALE 1.0E0;POSITION 0.050; 
COUPLING DC;BANDWIDTH OFF; <INVERT OFF;> 


sHORIZONTAL: VIEW MAIN;MAIN: SCALE 5.0E-4; 
POSITION 0.0E0; 


: HORIZONTAL: DELAY:SCALE 5.0E-5;POSITION 0.0E0; 
: TRIGGER:MAIN:MODE AUTO;TYPE EDGE;HOLDOFF:VALUE 5.0E-7; 
: TRIGGER:MAIN: EDGE: SOURCE CH1;COUPLING DC;SLOPE RISE; 


: TRIGGER: MAIN: VIDEO:SOURCE CH1;SYNC LINE; 
POLARITY NORMAL; 


: TRIGGER:MAIN:LEVEL 0.0E0; 
:SELECT:CH1 1;CH2 0;MATH 0;REFA 0;REFB 0; 
:CURSOR: FUNCTION OFF;SELECT:SOURCE CH1; 
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: CURSOR: VBARS: UNITS SECONDS; POSITION1 -2.0E-3; 
POSITION2 2.0E-3; 


= CURSOR: HBARS: POSITION -3.2E0;POSITION2 3.2E0; 

: MEASUREMENT :MEAS1: TYPE NONE;SOURCE CH1; 

: MEASUREMENT :MEAS2: TYPE NONE;SOURCE CH1; 

: MEASUREMENT :MEAS3: TYPE NONE;SOURCE CH1; 

: MEASUREMENT :MEAS4: TYPE NONE;SOURCE CH1; 

: MEASUREMENT: IMMED: TYPE PERIOD;SOURCE CH1; 
sMATH:DEFINE "Chl - Ch2"; 

<:MATH:DEFINE "Chl + Ch2";> 

<:MATH: FFT: HORIZONTAL: POSITION 5.0E1; SCALE 1.0E0;> 
<:MATH: FFT: VERTICAL: POSITION 0.0E0; SCALE 1.0E0;> 
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ASCII 
Acronym for the American Standard Code for Information 
Interchange. Controllers transmit commands to the digitizing 
oscilloscope using ASCII character encoding. 


Address 
A 7-bit code that identifies an instrument on the communication 
bus. The digitizing oscilloscope must have a unique address for 
the controller to recognize and transmit commands to it. 


Backus-Naur Form (BNF) 
A standard notation system for command syntax. The syntax in 
this manual use BNF notation. 


Controller 
A computer or other device that sends commands to and accepts 
responses from the digitizing oscilloscope. 


EOI 
A mnemonic referring to the control line “End or Identify” on 
the GPIB interface bus. One of the two possible end-of-message 
terminators. 


EOM 
A generic acronym referring to the end-of-message terminator. 
The end-of-message terminator is either an EOI or the ASCII 
code for line feed (LF). 


IEEE 


Acronym for the Institute for Electrical and Electronic 
Engineers. 


QuickBASIC 


A computer language (distributed by Microsoft) that is based on 
the Beginner’s All-Purpose Symbolic Instruction Code. 
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QuickC 
A computer language (distributed by Microsoft) that is based on 
the C programming language. 


RS-232 
A serial, full-duplex, asynchronous communication port that 
follows ANSI/EIA/TIA-—562-1989[1], ANSI/EIA/ 
TIA—574-1990[2], and CCITT V.24—-1989[3] standards. 
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Index 
Symbols 


*OPC, 3-14 
*WAIT, 3-11 


A 


Abbreviating commands, 2-5 
ACQUIRE?, 2-33 
ACQUIRE:MODE, 2-34 
ACQUIRE:NUMACQ?, 2-35 
ACQUIRE:NUMAVG, 2-36 
ACQUIRE:STATE, 2-37 
ACQUIRE:STOPAFTER, 2-38 
Acquisition command group, 2-15 
ALLEV?, 2-39 

Argument, command, 2-2 
ASCII, 2-1 

AUTORANGE, 2-40 


Block, command argument, 2-12 
BNF (Backus-Naur form), 2-1 
Break signal, 2—5 

BUSY?, 2-40, 3-13 


C 


*CAL?, 2-42 
Calibration and diagnostic 
command group, 2—16 
Calibration and diagnostic 
commands 
*CAL?, 2-42 
CALibrate: ABORT, 2-43 
CALibrate: CONTINUE, 2-43 
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CALibrate:FACTory, 244 

CALibrate: INTERNAL, 2-45 

CALibrate:STATUS?, 246 

DIAG:RESULT:FLAG?, 2-76 

DIAG:RESULT:LOG?, 2-77 

ERRORLOG:FIRST?, 2-82 

ERRORLOG:NEXT?, 2-82 
CH<x>?, 2-46 
CH<x>:BANDWIDTH, 2-47 
CH<x>:COUPLING, 2-48 
CH<x>:INVERT, 2-49 
CH<x>:POSITION, 2-50 
CH<x>:PROBE?, 2-52 
CH<x>:SCALE, 2-53 
CH<x>: VOLTS, 2-54 
Channel, command mnemonic, 2-8 
CH<x>, command mnemonic, 2—8 
Clear status, 2—55 
*CLS,2—-55 
Command 

*OPC, 3-14 

*WAIT, 3-11 

abbreviating, 2-5 

argument, 2—2 

block argument, 2—12 

BUSY?, 3-13 .- 

common, 2—21, 2-23 

concatenating, 2-6 

header, 2—2 

message, 2—2 

mnemonic, 2—2 

query, 2—2 

rules for forming, 2-1 

separator, 2-2 

set, 2-2 

synchronizing, 3-10 

syntax, 2-1 
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Command argument 
numeric, 2—9 
quoted string, 2-11 
Command entry rules, 2-5 
Command group 
acquisition, 2-15 
calibration and diagnostic, 2-16 
Cursor 2a) 
display, 2-18 
hardcopy, 2-18 
horizontal, 2-19 
measurement, 2—20 
miscellaneous, 2—21 
RS-232, 2-22 
save and recall, 2—23 
status and error, 2—23 
trigger, 2-24 
vertical, 2-25 
waveform, 2—26 
Command mnemonic 
channel, 2-8 
CH<x>, 2-8 
Cursor position, 2—9 
measurement specifier, 2-8 
MEAS<x>, 2-8 
POSITION<x>, 2-9 
reference waveform, 2-9 
REF<x>, 2—9 
waveform, 2-9 
<wim>, 2-9 
Command syntax, 2-1 
Common command, 2—23 
Common GPIB commands 
*CAL?, 2-42 
CALibrate: CONTINUE, 2-43 
CALibrate:FACTory, 2-44 
CALibrate: INTERNAL, 2-45 
CALibrate:STATUS?, 246 
*CLS, 2-55 
Concatenating, command, 2-6 
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Configuration, command query, 
2-106 
Cursor command group, 2-17 
Cursor commands 
CURSOR?, 2-56 
CURSOR:FUNCTION, 2-56 
CURSOR:HBARS?, 2-57 
CURSOR:HBARS:DELTA?, 
2-58 
CURSOR:HBARS:POSI- 
TION<x>, 2-59 
CURSOR:HBARS:UNITS?, 
2-60 
CURSOR:SELECT:SOURCE, 
2-60 
CURSOR: VBARS?, 2-61 
CURSOR: VBARS:DELTA?, 
2-62 
CURSOR: VBARS:POSI- 
TION<x>, 2-63 
CURSOR: VBARS: UNITS, 2-64 
Cursor position, command mne- 
monic, 2—9 
CURVE, 2-65 


D 


DATA, 2-66 
DATA:DESTINATION, 2-67 
DATA:ENCDG, 2-68 
DATA:SOURCE, 2-70 
DATA:START, 2-71 
DATA:STOP, 2-72 
DATA:TARGET, 2-73 
Data Transfer 
from the oscilloscope, 2—32 
to the oscilloscope, 2-32 
DATA: WIDTH, 2-74 
* DDT, 2-74 
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DESE command, 2-75, 3-4 
DESER register, 2-75, 2-125, 3-4 
Device clear, 2—5 
DIAG:RESULT:FLAG?, 2-76 
DIAG:RESULT:LOG?, 2-77 
Display command group, 2-18 
Display commands 
DISPLAY ?, 2-78 
DISPLAY:CONTRAST, 2-78 
DISPLAY:FORMAT, 2-79 
DISPLAY:PERSISTENCE, 2-80 
DISPLAY:STYLE, 2-81 


E 


Entering commands, 2-5 

Entering incorrect numeric argu- 
ments, 2—11 

EOM (end of message), 2—7 

Error message, programming 
interface, 3—17 

ERRORLOG:FIRST?, 2-82 

ERRORLOG:NEXT?, 2-82 

*ESE, 2-83, 3-5 

ESER register, 2-83, 2-125, 3-5 

*ESR?, 2-84 

*ESR? query, 3-2 

Event handling, 3-1 

Event query, 2-85 

Event queue, 2-85, 3-7 

Event queue sequence, 3-8 

EVENT?, 2-85 

EVMSG?, 2-85 

EVQTY?, 2-86 

Examples 

block argument, 2—13 
quoted strings, 2-12 
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FACTORY, 2-87 
Factory setup, detailed description, 
B-1 


G 


GPIB, EOM (end of message), 2—7 


H 


Hard copy commands 
HARDCOPY, 2-89 
HARDCOPY:FORMAT, 2-90 
HARDCOPY:LAY OUT, 2-91 
HARDCOPY:PORT, 2-92 

Hardcopy command group, 2-18 

HDR, 2-93 

HEADER, 2-93 

Header 
command, 2—2, 2-93 
included in query response, 2-93, 

2-156 

Horizontal command group, 2-19 

Horizontal commands 
HORIZONTAL?, 2-94 
HORIZONTAL: DELAY ?, 2-95 
HORIZONTAL:DELAY:POSI- 

TION, 2-95, 2-98, 2-101 
HORIZONTAL:DELAY:SCALE, 

2-96 
HORIZONTAL:DELAY:SEC- 

DIV, 2-97 
HORIZONTAL:MAIN?, 2-98 
HORIZONTAL:MAIN 

‘SCALE, 2-99 
HORIZONTAL:MAIN 

:SECDIV, 2-100 
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HORIZONTAL:RECORD- 
LENGTH, 2-102 

HORIZONTAL:SCALE, 2-102 

HORIZONTAL:SECDIYV, 2-103 

HORIZONTAL: TRIGGER 
:POSITION, 2-104 

MATH:FFT:HORIZONTAL 
:POSITION, 2-111 

MATH:FFT:HORIZONTAL 
:SCALE, 2-112 


ID?, 2-105 

*IDN?, 2-106 

IEEE Std. 488.2—1987, 2-1, 2-21, 
2-23 


u 


LANGUAGE, 2-107 
LOCK, 2-108 
*LRN?, 2-109 


M 


Manual trigger, simulation with 
command, 2-142 
MATH)?, 2-110 
MATH:DEFINE, 2-110 
MATH:FFT:HORIZONTAL 
:POSITION, 2-111 
MATH:FFT:HORIZONTAL 
:SCALE, 2-112 
MATH:FFT: VERTICAL 
:POSITION, 2-113 
MATH:FFT: VERTICAL 
:SCALE, 2-114 
Measurement command group, 
2-20 


Index-4 


Measurement commands 
MEASUREMENT?, 2-115 
MEASUREMENT: IMMED?, 

2-115 
MEASUREMENT:IMMED: 

SOURCE, 2-116 
MEASUREMENT:IMMED 

:TYPE, 2-117 
MEASUREMENT: IMMED 

:UNITS?, 2-118 
MEASUREMENT:IMMED 

:VALUE?, 2-119 
MEASUREMENT 

:MEAS<x>?, 2-120 
MEASUREMENT 

-MEAS<x>: TYPE, 2-121 
MEASUREMENT 

-MEAS<x>: UNITS?, 2-122 
MEASUREMENT 

:MEAS<x>: VALUE?, 2-123 
MEASUREMENT:MEAS<x> 

:SOURCE, 2-120 

Measurement specifier, command 
mnemonic, 2-8 
MEAS<x>, command mnemonic, 
2-8 

Message 
command, 2-2 
command terminator, 2—7 
handling, 3-1 
table of program messages, 3-17 

Miscellaneous command group, 

2-21 

Miscellaneous commands 
AUTORANGE, 2-40 
*DDT, 2-74 
FACTORY, 2-87 
HDR, 2-93 
HEADER, 2-93 
*IDN?, 2-106 
LANGUAGE, 2-107 
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LOCK, 2-108 

*LRN?, 2-109 

REM, 2-128 

SET, 2-139 

*TRG, 2-142 

UNLOCK, 2-155 

VERBOSE, 2-156 
Mnemonic, command, 2-2 


N 


Numeric, command argument, 2-9 
Numeric argument coercion, 2-11 


0 


*OPC, 2-124 

Operation complete command, 
2-124 

Operation complete wait, 2-157 

Output queue, 3-6 


p 


POSITION<x>, command mne- 
monic, 2-9 

Power-on status clear command, 
2-125 

Preamble, waveform, 2-31 

*PSC, 2-125 

*PSC command, 3-6 


Q 


Query, header in query response, 
2-93, 2-156 
Query command, 2-2 
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Queue 
event, 3—7 
event handling sequence, 3-8 
output, 3-6 
Quoted string, command argument, 
2-11 
Quoted string examples, 2-12 
Quoted string rules, 2-11 


R 


*RCL, 2-126 
Recall setting command, 2—126 
RECALL:SETUP, 2-127 
Reference waveform, command 
mnemonic, 2—9 
REF<x>, command mnemonic, 
2-9 
Register 
DESER, 2-75, 2-125, 3-4 
ESER, 2-83, 2-125, 3-5 
SBR, 2-141, 3-3 
SESR, 2-55, 2-84, 2-124, 3-2 
SRER, 2-125, 2-140, 3-5 
REM, 2-128 
Reset 
command, 2-134 
to factory settings, 2-87 
RS-232 command group, 2-22 
RS232 commands 
RS232?, 2-128 
RS232:BAUD, 2-129 
RS232: HARDFLAGGING, 
2-130 
RS232:PARITY, 2-131 
RS232:SOFTFLAGGING, 2-132 
RS232:TRANSMIT 
:TERMINATOR, 2-133 
*RST, 2-134 


Index-5 


Index 


Rules, command forming, 2-1 SRER register, 2-125, 2-140, 3-5 
Rules, command entry, 2-5 Status, 3-1 
Rules, quoted strings, 2-11 Status and error command group, 
2-23 
P Status and error commands 
S ALLEV?, 2-39 
USY?, 240 
*S AV, 2-135 ep a 
3 jf : *CLS 22455 
AK oy recall command group, DESE, 2-75, 3-4 
ey i Hg *ESE, 2-83, 3-5 
ave and reca a *ESR?, 2-84, 3-2 
SRL aD oie aie EVENT?, 2-85 
RECALL:SETUP, 2-127 9 
erm EVMSG?, 2-85 
*SAV, 2-135 at EVQTY?, 2-86 
SAVE:SETUP, 2-136 *' ID?. 2-105 
SAVE: WAVEFORM, 2-137 eG 
OPC, 2-124 
Save setting command, 2-135 *PSC_ 2-125. 3-6 
SAVE:SETUP, 2-136 *RST, 2-134 


SAVE:WAVEFORM, 2-137 
SBR register, 2-141, 3-3 
SELECT?, 2-138 


*SRE, 2-140, 3-5 
*STB?, 2-141, 3-3 


* 9) toes 
SELECT:<wfm>, 2-138 TST?, 2-155 
Self test, 2-155 *WAI, 2-157 
ENE *STB?, 2-141 


Separator, command, 2-2 : 7 
Serial poll, 3-3 STB? query, 3-3 


Synchronizing commands, 3-10 
Service request enable command, 
7140 Syntax 


; BNF (Backus-Naur form), 2—1 
Service request enable register, 


7140 command, 2-1 
SESR register, 2-55, 2-84, 2-124, 
3-2 T 
Set command, 2—2 
SET?, 2-139 Table, programming message, 3-17 
Setting TDS2MM-telated commands 
command query, 2—109 CH<x>:INVERT, 2-49 
query, 2-109 MATH: DEFINE, 2-110 
recall command, 2—126 MATH:FFT:HORIZONTAL 
save command, 2—135 :POSITION, 2-111 
Setups, factory setup description, MATH:FFT:HORIZONTAL 
B-1 “SCALE, 2-112 


*SRE command, 2-140, 3-5 
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MATH:FFT: VERTICAL 
:POSITION, 2-113 
MATH:FFT: VERTICAL 
‘SCALE, 2-114 
MEASUREMENT: IMMED 
‘TYPE, 2-117 
MEASUREMENT:MEAS<xX> 
:TYPE, 2-121 
WFMPRE:<wfm> 
:WFID?, 2-180 
WEMPRE:<wfm> 
:XINCR, 2-181 
WFEMPRE:<wfm> 
:XUNIT, 2-183 
WEMPRE:<wfm> 
:XZERO, 2-184 
WFEMPRE:<wfm> 
:-YMULT, 2-185 
WFEMPRE:<wfm>: Y OFF, 2-186 
WEMPRE:<wfm> 
:YUNIT; 2-188 
WEMPRE: WFID?, 2-166 
WFMPRE:XINCR, 2-167 
WFMPRE:XUNIT, 2-169 
WFMPRE:XZERO, 2-170 
WEMPRE:Y MULT, 2-171 
WFMPRE:Y OFF, 2-172 
WEMPRE:YUNIT, 2-174 
WFMPRE: YZERO, 2-175, 
2-190 
Tek Std. Codes and Formats 1989, 
2-21, 2-23 
Terminator, command message, 
2-7 
Time base, manual trigger simula- 
tion, 2-142 
Transferring data 
from the oscilloscope, 2-32 
to the oscilloscope, 2-32 
*TRG, 2-142 
TRIGGER, 2-142 
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Trigger command group, 2—24 
Trigger commands 
TRIGGER, 2-142 
TRIGGER:MAIN, 2-143 
TRIGGER:MAIN:EDGE?, 
2-144 
TRIGGER:MAIN: EDGE 
:COUPLING, 2-145 
TRIGGER:MAIN: EDGE 
:SLOPE, 2-146 
TRIGGER:MAIN: EDGE 
:SOURCE, 2-146 
TRIGGER:MAIN:HOLDOFF?, 
2-147 ..: 
TRIGGER:MAIN: 
HOLDOFF: VALUE, 2-148 
TRIGGER:MAIN 
:LEVEL, 2-149 
TRIGGER:MAIN:MODE, 2-150 
TRIGGER:MAIN:TYPE, 2-150 
TRIGGER:MAIN: VIDEO 
-FIELD, 2-151 
TRIGGER:MAIN: VIDEO 
:POLARITY, 2-152 
TRIGGER:MAIN: VIDEO 
:SOURCE, 2-152, 2-153 
TRIGGER:STATE?, 2-154 
TRIGGER:MAIN, 2-143 
TRIGGER:MAIN:EDGE?, 2-144 
TRIGGER:MAIN:EDGE 
:COUPLING, 2-145 
TRIGGER:MAIN:EDGE 
‘SLOPE, 2-146 
TRIGGER:MAIN:EDGE 
‘SOURCE, 2-146 
TRIGGER:MAIN 
‘HOLDOFF?, 2-147 
TRIGGER:MAIN:HOLDOFF 
: VALUE, 2-148 
TRIGGER:MAIN:LEVEL, 2-149 
TRIGGER:MAIN:MODE, 2-150 
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TRIGGER:MAIN:TY PE, 2-150 
TRIGGER:MAIN: VIDE®@: : ’- 
‘FIELD, 2-151 aie 
TRIGGER:MAIN: VIDEG: :. 
:POLARITY, 2-152 «ij! 
TRIGGER:MAIN: VIDEO: } 
‘SOURCE, 2-152, 241153 
TRIGGER:STATE?, 2-154: 
*TST? query, 2-155. )4.3%; 


oes ee 


U 


UNLOCK’ 2-155" 


V 


VERBOSE, 2-156 

Vertical bar cursors, 2-61 

Vertical command group, 2-25 

Vertical commands 
CH<x>?, 2-46 
CH<x>:BANDWIDTH, 2-47 
CH<x>:COUPLING, 2-48 
CH<x>:IN VERT, 2-49 
CH<x>:POSITION, 2-50 
CH<x>:PROBE?, 2-52 
CH<x>:SCALE, 2=53 
CH<x>: VOLTS, 2-54 
MATH?, 2-110 
MATH:DEFINE, 2-110 
MATH:FFT: VERTICAL 

:POSITION, 2-113 
MATH:FFT: VERTICAL 
‘SCALE, 2-114 

SELECT?, 2-138 
SELECT:<wfm>, 2-138 
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*WAI, 2-157 
Wait for operation complete, 2-157 
Waveform, command mnemonic, 
2-9 
Waveform command group, 2—26 
Waveform commands 
CURVE, 2-65 
DATA, 2-66 
DATA:DESTINATION, 2-67 
DATA:ENCDG, 2-68 
DATA:SOURCE, 2-70 
DATA:START, 2-71 
DATA:STOP, 2-72 
DATA:TARGET, 2-73 
DATA: WIDTH, 2-74 
WAVFRM?, 2-158, 
WFEMPRE?, 2-158 
WEMPRE:<wfm>?, 2-177 
WEMPRE:<wfm> 
:PT_FMT, 2-178 
WFEMPRE:<wfm> 
:PT_OFF, 2-179 
WEMPRE:<wfm> 
:WFID, 2-180 
WEMPRE:<wfm> 
:XINCR, 2-181 
WEMPRE:<wfm> 
:XUNIT, 2-182, 2-183 
WEMPRE:<wfm> 
:XZERO, 2-184 
WFEMPRE:<wfm> 
> YMULT, 2-185 
WEMPRE:<wfm> 
: YOFF, 2-186 
WFEMPRE:<wfm> 
:YUNIT, 2-187, 2-188 
WEMPRE:<wfm> 
-YZERO, 2-189 
WFEMPRE:BIT_NR, 2-159 


TDS 200-Series Programmer Manual 


Index 


WEMPRE:BN_FMT, 2-160 WFMPRE:YMULT, 2-171 
WFMPRE:BYT_NR, 2-161 WEMPRE: YOFF, 2-172 
WFMPRE:BYT_OR, 2-161 WFMPRE:YUNIT, 2-173, 2-174 
WEMPRE:ENCDG, 2-162 WFMPRE!YZERO, 2-175 
WFMPRE:NR_PT?, 2-163 WFMPRE:YZERO 
WEMPRE:PT_FMT, 2-164 (TDS2MM Version), 2-175 
WFMPRE:PT_OFF, 2-165 WEFEMPRE:ZMULT, 2-176 
WFMPRE:WFID, 2-166 WFMPRE:ZOFF, 2-176 
WFMPRE:XINCR, 2-167 WFMPRE:ZUNIT, 2-176 
WFMPRE: XMULT, 2-176 WFMPRE:ZZERO, 2-176 
WFMPRE: XOFF, 2-176 Waveform preamble, 2-31 
WFMPRE:XUNIT, 2-168, 2-169 WAVFRM)?, 2-158 
WEMPRE:XZERO, 2-170 <wfm>, command mnemonic, 2—9 
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